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Introduction to UNIFY 


The UNIFY Relational Data Base Management System provides you 
with a comprehensive set of application development tools. With 
these tools, you can easily develop high performance data storage and 
retrieval systems: 


• 
from payroll processing to personnel tracking 


• 
from inventory management to market researching 
Using UNIFY's nonprocedural, menu-driven design, you can quickly 
develop complex and powerful applications without programming, 
and with no need to memorize commands. 


About this Manual 


This manual serves as a tutorial guide to the UNIFY systems 
development process. It presents a real-world situation where UNIFY 
could be used, and shows you step-by-step how to build the 
application. 


When you're finished, you will have used most of th~ UNIFY tools in 
the context of the tutorial example. You should then be well- 
equipped to start on the development of your own applications. 


What You Should Know 


While this manual is intended for both experienced and less 
experienced users, it assumes that you: 


• 
comprehend the basic operating system shell commands (like 
Is(l), cd(l), and Ipr(1)), how directories work, and how to use a 
text editor 


• 
understand the concepts of storing and retrieving information 
using a computer 
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The data base terms we will be using in this manual are as follows. 


TERM 
DESCRIPTION 
field 
the smallest unit of 
data the system 
recognizes 
record 
one occurrence of a 
record type 
record type 
a named group of 
logically related fields 


The Tutorial Example 


The example application system in this tutorial is for the Acme 
Hardware Warehouse. Acme is a company that supplies tools to 
retail hardware stores. 


Manufacturers supply the tools to Acme, which stocks them in its 
inventory. 
Your progress through the tutorial involves setting up an inventory 
data base to track each manufacturer, model, and item. 
After adding the initial stock to the inventory, you will expand the 
data base design to allow for customers, orders, and a way to keep 
track of profits. 
Visualizing the Example 


The following diagram illustrates the example data base design, 
which contains manufacturer, model, and item record types and their 
associated fields. 


manufacturer 
ID number 


manufacturer 
ID number 
description 
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acquisition 
date 
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The manufacturer, model, and item are the basic record types of the 
tutorial example. 
The fields that make up the manufacturer record type are the 
manufacturer's unique identification number, the manufacturer 
name, and the address. 


The fields of the model record type are the model number, the 
manufacturer identification number, and the description. Together, 
the model number and the manufacturer ID number fields indicate 
who makes this particular model. 
The fields of the item record type are the serial number, the model 
number, the manufacturer identification number, the acquisition 
date, and the sales price. Together, the model number and the 
manufacturer ID number fields indicate what model this item 
represents. The acquisition date is the date the item became part of 
the inventory. 


Illustrating the Data Base 


Entering specific information for the manufacturer, model, and item 
record types gives us a small data base: 


MANUFACI'URER 
manufacturer 
address 
ID number 
name 


100 
RH Smith Manufacturing 
523 Galveston Ave. 
101 
Precision Tool Co. 
2600 West 16th Street 
102 
A & H Industries, Inc. 
2434 Evergreen Ave. 


MODEL 
model 
manufacturer 
description 
number 
ID number 
1001 
100 
1/2" socket wrench 
55271 
101 
combination pliers 
1002 
102 
leather mallet 


ITEM 
serial 
model 
manufacturer 
acquisition 
sales 
number 
number 
ID number 
date 
price 
1001 
1001 
100 
2/15/82 
$9.75 
1006 
55271 
101 
1/19/82 
$6.89 
1007 
1002 
102 
1/19/82 
S8.75 
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Notice that you can discover the relationships between the three 
record types simply by examining the data. 


Suppose, for example, you want to ~ow who makes model number 
1001. Looking at the model records, you can see the manufacturer 
ID number is 100. Then looking at the manufacturer records, you 
can see that manufacturer 100 is RH Smith Manufacturing. 


As another example, suppose you want to know what item number 
1007 identifies. Looking at the item records, you can see the model 
number is 1002. Then looking at the model records, you can see that 
model 1002 is a leather mallet. 


Reviewing Relationships 


These examples illustrate the basic ideas of a relational data base: 


• 
all the data are stored in simple, "fllit" files 


• 
all relationships are indicated by data values 


Relationships occur when the record types contain common fields. 
The common fields can then be used to relate one record to another. 


Other data base models - 
including network and CODASYL - 
specify relationships by "set orderings" or "owner-member" concepts. 
These older concepts are less flexible and less powerful. 
In the example, the manufacturer, model, and item record types 
exhibit "one to many" relationships between manufacturers and 
models, and between models and items. 


Expanding the Application 


Most applications change over time, and this one is no exception. 
After you have created the basic data base and added some data, you 
will add some additional features. 


Each retail hardware store that Acme caters to is a customer. And 
each customer places orders. You will expand the data base design 
to include information on each customer and its orders, as well as 
additional information on manufacturers and items. 
The new data base design can be pictured as follows: 


MANUFACl'URElt 
I~:~urer I-na--mc-rl-ad-d-rcu--'EEU;J 


MODEL 
Imodel Imanufacturer Idescription 
number 
ID number 
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manufacturer 
ID number 
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The fields of the customer record type are the customer's unique 
identification number, name, street address, city, state, Zip code, and 
phone number. 
The fields of the orders record type are the order number, date, and 
customer identification number. 
These record types allow you to group items on an order for a 
customer. Since there can be several items on one order - 
with 
each item representing a different model - 
an order can contain 
several models. 
The item then becomes an intersection between model and orders. 
This type of relationship between model and orders is a "many to 
many" relationship. 
This final design is not a definitive example of such an inventory 
system. Rather, it illustrates the process of applications development 
without obscuring that process with details. 
In Summary 
This tutorial manual shows you step-by-step how to develop the 
Acme Hardware Warehouse data base system. Along with this 
introduction, the manual contains an index and 13 sections. A 
description of each section is as follows. 


Section 1. "Starting up UNIFY" shows you how to create a 
directory structure and sign on to UNIFY. 


This establishes the UNIFY environment for program 
development and operation. UNIFY takes full advantage of 
operating system directories and self-guiding menus. 


The directory structure simplifies program development and 
maintenance. 
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The interactive menu structure guides you through the 
development and maintenance of data base applications. 
Section 2.. "Designing and Creating a New Data Base" explains how 
with one UNIFY function, you can create the data base design, the 


d~ta base file, file maintenance screens, and a menu. 
Once you design record types and their associated fields, you 
select from a set of options to perform the other steps. 
Section 3. "Adding Data with ENTER" instructs you how to use 
UNIFY's interactive data entry tool, ENTER. 
When you enter the test data, you see how ENTER screens 
work. Plus, you develop a test data base for queries and reports. 
Section 4. "Modifying a Data Base Design" allows you to change 
the data base design to reflect new requirements. 


As an application expands, new capabilities require data base 
design modifications. Here, you see how easy UNIFY makes 
these changes. 


Section S. "Modifying Data Entry Screen Forms" describes how you 
modify existing screen forms with PAINT to reflect changes to the 
data base design. 


YGU can also update the data base records by adding values for 
the new fields. 


Section 6. "Using the SQL Query/DML Langua.ge" acquaints you 
with the SQL Query/DML language so you can extract information 
from the data base. 
Since the tutorial contains a limited data base, it is difficult to 
detail SQL's entire capabilities. For examples of additional SQL 
features, see the UNIFY Reference Manual. 
Section 7. "Using the Report Processor" explains how to use the 
UNIFY report writer, RPT. 
This section shows how to get a report from an ASCII file. 
Later sections show how to connect RPT to ENTER and SQL. 


Section 8. "Describing Programs to the Menu Handler" shows you 
how to create and register SQL and RPT scripts with the Menu 
Handler. 
This feature allows you to run scripts without interacting with 
the shell. This lets very inexperienced users have easy access to 
predefined reports. 
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Section 9. "Query By Forms Using ENTER" explains the use of 
ENTER screens to query the data base. 


ENTER provides a useful and powerful query by forms 
capability. You simply enter information in the blanks on a 
screen form, and ENTER efficiently queries the data base to 
retrieve the indicated data. 
Plus, you can associate report scripts with these ENTER screens. 


Section 10. "Using SQL By Forms" describes how to use an SQL 
screen to query the data base. 
The SQL screen driver provides an easy to use method of 
substituting values in SQL and RPT scripts. You simply enter 
information in the blanks on a screen form, and those values 
complete the query and report scripts. 


Section U. "Creating Help Documentation" provides you with 
instructions on entering and displaying help documentation for 
programs. 


UNIFY provides online help documentation to enhance your 
training and give you immediate access to this manual. 


Section 12. "Modifying UNIFY Menus" allows you to create a tree- 
structured applications menu system. 


This illustrates the powerful and flexible use of the Menu 
Handler to develop custom menus. 
Section 13. "Assigning Data Base Security" informs you how to 
control access to the data base by enabling a login screen and by 
setting privileges individually and collectively. 


You're now ready to start the UNIFY Tutorial Manual! 
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Section 1 
Starting up UNIFY 


1. STARTING UP UNIFY 


Welcome to UNIFY! 


This section shows you how to create a directory structure and start 
UNIFY. It also familiarizes you with the use of UNIFY menus, 
command keys, help text, and menu options. At the end is a map of 
the standard UNIFY system menus. 


Beginning the Tutorial 


You start the tutorial by creating two directories, one for the data 
base and another for help text. This is because the UNIFY system 
works best in a specific directory structure. 


o 
STEP 
1: 


Note: 


o 
STEP 
2: 


Note: 


Action: 


Effect: 


Login to the operating system. 
If you don't know how to do this, refer to your 
operating system documentation or consult your 
system administrator. 


Create the standard UNIFY directories. 


The directory must be located in a file system with 
at least 1500 free blocks (800k bytes). The data 
base application you will be developing will require 
this much space. 


Enter the following: 


mkdir bin Moe lRETURNl 


This command creates the directories that UNIFY 
uses. The directories are used as follows. 


DIRECTORY 
CONTENT 
bin 
data base, data dictionary, 
and executable ASCII files 
hdoc 
on-line help documentation 
to describe the system 
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No~e: 


o 
STEP 
3: 
Action: 


Effect: 


Note: 


o 
STEP 
4: 
Action: 


Effect: 


1-2 


You must press the IRETURNI key or its equivalent 
to complete an entry, except when stated otherwise. 


Change to the bin directory and start up UNIFY. 


Enter the following: 


cd bin 
unify 


When you use UNIFY, you use one data base at a 
time. Once you create the bin and hdoc directories, 
you begin the development of the data base 
application by changing the working directory to 
bin. 
You're now in the bin directory where there is a file 
system with enough space. UNIFY now starts. The 
screen clears and the following prompt displays at 
the bottom. 


Do you wish to create a new data dictionary7 • 


The highlighted box (.) representsthe cursor. An 
underscore U may also represent the cursor in 
some diagrams, although one of the two doesn't 
always appear. 


Create a new data dictionary. 
Enter a y to answer yes to the question as shown: 


Do you wish to create a new data dictionary7 y. 


You're asked 
this 
question because the 
UNIFY 
system doesn't find an existing data dictionary in 
this directory. 
The data dictionary stores the ele- 
ments of your application, such as the data base 
design, screen forms, and menus. 


The following message replaces the question. 


Creating new data dictionary...• 


( 


Starting up UNIFY 


You tell the UNIFY system to copy an empty data 
dictionary file (unify.db) from the system lib direc- 
tory. When this completes, the UNIFY Main Menu 
displays. This is your home menu. 


UNIFY Menus 
Your data dictionary now contains only the UNIFY system menus. 


A menu is a list of UNIFY options you can select. Menus are used 
to: 


• 
create an application 


• 
operate the application 
As you create and operate an application, all processes are menu 
driven. 


The menu control program is known as the Menu Handler. The 
Menu Handler provides you a complete, secure, user friendly 
environment for the entire system. 


With the Menu Handler, you can: 


• 
create and maintain sets of independent menus 


• 
update your data dictionary to keep track of menus, application 
functions, data entry screen forms, and users of an application 
system 


• 
control the security privileges of each menu and its options 
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Reviewing the UNIFY Main Menu 


[I":'.a:'nmenu] 
1------- 


2 


UN4FY Ralaass 3.2 
UN4FY Main Msnu0 


2. Create or Modify Scr.en Forma 


3. 
s~ _ auary/OML Lanquaqa 


3 


10 JAN 1985 _ 14:22 


4. Edit s~ or aPT Command Filas 
~ 


~ 5. Add, Modify or Oalata Manus 


6. Oata Baaa Oasiqn Utilitias 


7. 
Systam Administration0 


® 
SELECT40N: • 
--------- 
'"~<::'F x," . ,,' 
~...... 
::~:;:mr".-::"~,'X>;:~l·:*~W.< 
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The UNIFY Main Menu is similar to'all system menus. A menu has 
the following components. 


CD 0 
CD and 0 
Header Information. Respectively, the top two 
lines of the header consist of the menu's system name 
(mainmenu), system heading (UNIFY Release 3.2), date and 
time, and descriptive heading (UNIFY Main Menu). The 
.information in the top two lines displays for all programs and 
screen forms. 


® 
Menu Lines. This is a list of options you can select. The 
UNIFY system allows up to 16 menu lines per menu. 


® 
Selection Number. This is the line number for the menu line. 
The number can be used to select' an option. 
o 
Option Heading. This is a descriptive heading of the option. 


® 
Menu Pointer. This marks the current selection on the menu 
with either reverse video text or an asterisk. 


On the menu, the type of menu pointer depends on your 
terminal's capabilities. (For information on terminal 
capabilities, see the UNIFY Reference Manual.) 
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® 
Selection Prompt. At this prompt, you can enter a selection 
number or a system name to indicate your choice of options. 


@) 
Command Key Line. This line displays the command keys you 
can use with the Menu Handler. 
@ Command Key. The key represents the actual keystroke you 
enter. The indicated keystroke tells the Menu Handler to 
perform a specific command. 


@ Command Name. This is a short description of what function 
the command performs. 


@ Command Key Set. The set: 


commandJey-command..Jlame 


relates a command key with a command name. Each command 
key set displays in this format. 


Command Keys 


The Menu Handler normally assigns command keys to commands by 
default as follows. 
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WHEN you want to... 
THEN use the following... 
Key 
Name 
select the highlighted 
ESC or FI 
select 
option 
move the menu 
~U, l (UP-ARROW), 
up 
pointer up 
or ~K 


move the menu 
RETURN, 
down 
pointer down 
! (DOWN-ARROW), 


~J, or LINE FEED 
go to the home 
~X, HOME, 
home 
menu 
or F2 
go to the 
~P or F3 
previous 
previous menu 
clear the selection 
~Z, 
clear 
line 
DELETE, or F4 
exit UNIFY 
~D or F5 
exit 
display the general 
? or F6 
help 
Menu Handler help 
display more 
/ or FlO 
more 
command keys 
display information 
TAB, 
~I, 
info 
on the highlighted 
or F7 
menu line 
redraw the screen 
~R or F8 
redraw 
turn the command 
~T or F9 
toggle 
key line onloff 


How a' command key works. 


As an example, suppose you want to move the menu pointer up. 
Take a look at the appropriate command key set. Notice the key ~U. 
This relates to the keystrokes ICTRLI ill]. Press the ICTRLI and ill] 
keys at the same time. 


As another example, suppose you want to go to the home menu. 
Looking at the command key set, notice the key ~X. This relates to 
the keystrokes ICTRLI 00. Press the ICTRLI and 00 keys at the 
same time. 
(You can define your own command keys by modifYIng the uNIFY 
unicap file. For information on this subject, see the UNIFY 
Reference Manual.) 
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How a command key operates. 
As a demonstration, take a look at the general Menu Handler help 
text. 


o 
STEP 
5: 


Action: 
Effect: 


Request help information. 


Press the ill key. 
The "How to Use the UNIFY Menus" help text 
displays as shown. 


( 


HOW TO USE 'rHl!: l1IlJ:FY MENUS 


Each menu list. the current optiona that are Associated with it. 
An option ean be either & program, 
ENTER acre.n. 
SQL acr••u t 
or another menu. 


selections can be made by either: 


1. selection number 


or 
2. 
the 
- ••lect- 
command key 


1, Selection number. are the lin. number. before .ach option Ii_ted on the 
current menu. 
Example: 


(to ••lect the option on the fourth menu line) 


SELECTION: 
4 


2. 
Selections can a1ao be made by pr•••inq the 
- ••lect- 
command key. 
The 


op~iona hiihliih~a4 by 
~ha manu 
poin~ar vill ba 
axacu~a4. 


Diaplay 
na~ P&ia? (RETl1RX] 
con~inua •• 
(n] 
~armina~a•. a 


l 


o 
STEP 
6: 


Action: 
Effect: 


Page through the help information. 


Press IRETURNI after each page. 
The UNIFY Main Menu redisplays. 
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Selecting Menu Options 
On the UNIFY Main Menu, there are seven UNIFY options you can 
select. There are three ways to select an option. 
You can make your selection by using either the: 


• 
selection number. Enter the line number of the option at the 
selection prompt as follows: 


SELECTION: 4 


Here, you choose the option listed on menu line number four. 


• 
select command. Press the select command key. Here, you 
choose the option marked by the menu pointer. 


• 
option's system name. Enter the name of the option as follows: 


SELECTION: screens 


Here, you choose the option on the menu referring to screens 
(Create or Modify Screen Forms). 


UNIFY assigns system names to options. Or, you can assign your 
own names by customizing the Menu Handler. 
Understanding the Organization of Menus 
The following is a "map" of the standard UNIFY system menus to 
help you understand their organization. 


l-g 


r 
,- 


Create or Modify Screens Forms 


MENU MAP 


Main Menu 


1. Design and Create a New Data Base 
2. Create or Modify Screen Forms 
3. SOL - Ouery/DMl language 
4 
Edit SOL or RPT Command Files 
5. Add, Modify or Delete Menus 
6. Data Base Design Utilities 
7. System Administration 
1 
Data Base Design Utilities 
System Administration 


1. Paint Screen Forms 
2. Register Screen Form with ENTER 
1. MOdify Data Base Design 
3. Register Screen Form with SOL 
2. Print Data Base Design 


4. Check Screen Form Coordinates 
3. Create Data Base 
5. Display List of Screens 
4. Write Data Base Backup 
6. Test Screens 
5 
Reconfigure Data Base 


7. Compile Screens 
6. Add, Drop B-Tree Indexes 


B. Restore Screen to Data Dictionary 
7. Advanced Field Attributes 
9. Create Default Screen Form 


1 Transaction logging Status 
2. Data Base Maintenance 
3. Security Maintenance 
4. Create or Modify Help Documentation 
5. Describe Program to System 
6. Program loading 
7. Data Dictionary Reports 


Data Base Maintenance 
Security Maintenance 
Data Dictionary Reports 


1. Write Data Base Backup 
en 
2. Read Data Base Backup 
1. Modify System Parameters & Security 
1 Pnnt Data Base Design 
Ii> 


3. Add, Drop B-Tree Indexes 
2. Add or Modify Group PriVileges 
2. Print Menus 
...... 
4. Rebuild the Hash Table 
3. Add or Modify Individual Privileges 
3. Print Screens 
S· 


5. Rebuild Explicit Relationships 
4. Print Group Privileges 
4. Print Group Privileges 


0Cl 


~ 


6 
Define Data Base Volumes 
5. Print Individual Privileges 
5. Print Individual Privileges 
'0 


7. Print, Display Data Base Statistics 
6. Field Security Maintenance 
6. Print Help Documentation 
c: 


..... I 


B. Display Hash Table Statistics 
7. Process Field Passwords 
7. Print List of Programs 
~ 


I 
9. Print, Display B-Tree Statistics 
'Tl 
\0 
-< 
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Section 2 
Designing and Creating a New Data Base 


2. Designing and Creating a New Data Base 
2.1 Defining Record Types 
2-3 
2.2 Defining Fields 
2-8 
2.3 Creating an Initial Data Base 
2-19 


c· 
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2. DESIGNING AND CREATING A NEW DATA BASE 


Now that you have started UNIFY, you can begin to develop a data 
base. UNIFY provides a quick and easy, one-step development 
facility called "Design and Create a New Data Base" to help you get 
going. 
. 


There are two distinct phases to the Design and Crea.te a New Data 
Base option: 


• 
the data base design phase 


• 
the data base create phase 
The data base design phase includes designing record types and their 
associated fields. 
The data base create phase allows you to select from a set of 
application development options to: 


• 
print a report of the data base design 
• 
create an empty data base using the new design 


• 
create data entry screens 


• 
create a menu 
The result of the two phases is a prototype application. 


You start this section by entering the data base design. This 
includes all record type and field definitions, and the relationships 
between record types. 
The following is the way UNIFY presents a data base design. 
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RECORD/FIELD 
REF 
TYPE 
LEN 
LONG NAME 
CD manf 
0 10 
manufacturer 
°mano 
NUMERIC 
4 
Manufacturer_ID 
IIIDllDle 
STRING 
30 
Name 


madd 
STRING 
30 
Address ® 


model 
50 
model 
°l1lOkey 
COMB 
Model..Xey 
011lOnum 
NUMERIC 
7 
Model....Number 
I1lOmano 
®mano 
NUMERIC 
4 
Manufacturer_ID 


!Ddes 
@STRING 
30 
Description 


(2) 


itsm 
100 
inventory_item 


00sno 
NUMERIC 
9 
Serial....Number 
imodel 
moltey 
COMB 
Model-ID 


iad 
DATE 
Acquisition-Date 


is&l 
AMOUNT 
5 
Sales...Price 


This report shows part of the design you enter as your data base 
application. The report has the following components. 
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<D 


® 


Record Type Name (man!). The name that identifies records 
with the same field structure. 
Expected Number (10). The expected number of records of 
this type that the data base stores. The number helps to 
calculate the physical storage requirements of the data base. In 
this report, there are 10 manf, 50 model, and 100 item records. 


Note: The expected numbers are only estimates. The actual 
number of records can exceed the number shown. You can 
increase the numbers as necessary. 


Field Name (monum). The name of a field in this record type. 


Primary Key. An asterisk before a field name indicates that 
this field is the primary key of the record type. You can 
access a record randomly by its primary key. The primary key 
must be unique. 
(If necessary, you can speed up particular queries by defining 
secondary keys. For information on secondary keys, see the 
UNIFY Reference Manual, Section 2.1.) 
Referenced Field (mano). The name of the primary key of 
another record type. This establishes an explicit relationship 
between two record types; in this case, between model and manf. 


Designing and Creating a New Data Base 


UNIFY can then do two things for you: 
• 
Only valid manufacturer ID numbers - 
those found in 
manf records - 
can be stored in the momano field. 


• 
manf records that have model records referring to them 
cannot be deleted. This lets UNIFY maintain logical data 
base consistency for you automatically. 


® 
Field Data Type. The data type of the field. The valid types 
are: NUMERIC, STRING,FLOAT, DATE, TIME, 
AMOUNT, and COMBINED. For information on field types 
and their valid lengths, see the UNIFY Reference Manual, 
Section 2.1. 
o 
Field Length. The display length (in characters) of the field. 


® 
Long Name. This is a more descriptive name you enter for 
record types and fields. SQL, ENTER, and other system options 
use this name. For information on SQL and ENTER, see 
Sections 6 and 9, respectively. 
You're now ready to start developing the data base application. 


2.1 DEFINING RECORD TYPES 


The first phase of Design and Create a New Data Base allows you to 
define record types and their associated fields. In this subsection, 
you define record types. 


From the end of Section 1, you see the following menu. 
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[r:'.ainmenu] 
UNIFY aalaaaa 3.2 


UNIFY llain llanu 
10 JAN 1985 _ 14:22 


SELECTION: 
1. 


3. 
SQL _ Quary/DIlL Lanquaqa 


4. Kdit SQL or aPT Command Fila. 


5. Add. llodify or Delata llanua 


6. Data Ba.a Da.iqn Utilitia. 


7. Sy.tam A4mini.tration 


o 
STEP 
1: 


Action: 


Effect: 
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Select "Design and Create a New Data Base" 
(dbcreate). 


Enter a 1 at the selection prompt as shown. 
The screen form displays as follows. 


Designing and Creating a New Data Base 


LN CMD RECORD 
EXPECTED 
LONG HAKE 


[dbcreat.] 
UNIFY a.l•••• 3.2 
O••iqn and Create & Hew Data Baa. 


DESCRIPTION 


10 JAH 1985 - 
H:22 


record type dAta 
8ntry are.. 


( 


l 


[N].xt paq., [P]r.v paq., 
[A]dd lin., or numb.r: • 


r.cord d.finition 


paqinq area 


The first screen form of the data base design phase is the record 
type entry screen. 


There are two entry areas on this screen: the record type entry area 
and the record definition paging area. 


The entry area is where you add new record type definitions. The 
paging area is where you can modify, delete, or move existing 
definitions. 
As you enter record type definitions on this screen, the system: 


• 
accepts your valid entries and responds immediately to your input 
• 
rejects your invalid entries and responds automatically by either 
reporting the error or skipping over an attribute 


Record type definitions display in a paged format. You can view 11 
definitions per page. 


The paging prompt: 


[N]ext page, [p]rev page, [A]dd line, or number: 


allows you to select a command for the record type entry screen. 
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WHEN you want to... 
THEN select... 
display the next page of record 
n (next page) 
type definitions 
display the previous page of 
p (previous page) 
record type definitions 
add new record types 
a (add line) 
display the page with the 
1-256 (number) 
indicated definition, and 
position the cursor at that 
definition 
terminate the data base design 
CfRLU 
phase and begin the create 
phase 


The record type entry screen has the following prompts. 
CD 
LN (Line Number). A line number that the system assigns. 
Use this number to reference the record type definition you 
want to access. 
o 
Cl\1D (Command). This is where you enter an operation 
command. The cursor marks the position of the current 
definition. You can move the cursor up or down the column by 
pressing ICTRLI IIll or IRETURNJ. The valid operation 
commands are as follows. 


WHEN you want to... 
THEN enter... 
modify the fields for the current record type 
f (field) 
modify EXPECfED, LONG NAME, or 
m (modify) 
DESCRIPTION for the current record type 
delete the current record type definition 
d (delete) 
renumber the current record type definition 
1-256 (number) 
and reorder the definitions on the screen 
redisplay the paging prompt at the bottom of 
q (quit) 
the screen 
® 
RECORD. A unique eight character name that identifies 
records with the same structure. The name can contain letters 
(upper and lower case), numbers, and the underscore character 
(_). It must begin with a letter. Use this name to reference the 
record type throughout the system. When you're in the record 
entry area, use IC"FRLI IIll in this column to terminate the 
record type entry mode and redisplay the paging prompt. 
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o EXPECIED. The number of records you expect to enter of this 
type. This number is an estimate. However, you can exceed 
this number by 66%. Then, you must increase it and 
reconfigure the data base. 


® 
LONG NAME. This is a more descriptive record type name of 
16 characters. The name can contain letters (upper and lower 
case), numbers, and the underscore character (_). It must 
begin with a letter. ENTER uses this name when creating 
screen headings and displaying error messages. 


® 
DESCRIPTION. A comment field where you can enter a 
description of the record type. After you enter a complete 
record type definition, you can display the field entry screen by 
pressing JRETURNI while in this column. 
While designing the data base, you can move the cursor as follows. 


WHEN you want to... 
THEN use... 
move the cursor forward (left to right) 
RETURN 
under the column heading 
.. 


move the cursor backward (right to left) 
CTRLU 
under the column heading 


Entering a Record Type Definition 


o 
STEP 
2: 


Action: 


Effect: 


Select add mode. 


Enter an a at the paging prompt. 
The cursor moves to the RECORD column and 
[A]DD mode displays in the heading. 


( 


[dbc.....t.j 
[AjDD 
UHIPY a.l•••• 3.% 


D••ip &nd. Cr••<te • 
Hev nat.a B••• 


10 JAM 1985 _ 14:2Z 


LH 
CM!) 
RECORD 
EXPEC'l'ED 
LOHG HAME 
DESCiUP'l'IOH 


men! 
10 
aanufac'tureX' 
• 
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o 
STEP 
3: 


Action: 


o 
STEP 
4: 


Action: 


Reason: 


Define the manufacturer record type. 


Enter the definition as shown. 


Remember to press IRETURN! after each entry. 


Display the field entry screen. 


Press IRETURN1 with the cursor·in the 
DESCRIPTION column. 


You're ready to define the fields for this record 
type. 


2.2 DEFINING FIELDS 


Again, the first phase of Design and Create a New Data Base allows 
you to define record types and their associated fields. 
In this 
subsection, you define the fields for the manf record type. 


REWRD:rili_iWI.i\fI~ 
record name display area I 


LN 
CllD 
FIELD 
KEY 
REP 
TYPE 
LEN 
LONG NAME 


(dbcreate] 
UNIFY Releaae 3.2 


O.sign and Create & Mew DatA Baae 


10 JAM 1985 _ 14:22 


field definition 
entry area 


COMB. PIELD 


field definition 
paqinq area 


2-8 


( 


Designing and Creating a New Data Base 


The second screen form of the data base design phase is the field 
entry screen. The operation of this screen is very similar to the 
previous one. 


There are two entry areas on this screen: the field entry area and the 
field definition paging area. 


The entry area is where you add new field definitions. The paging 
area is where you can modify, delete, or move existing definitions. 


As you enter or modify field definitions on this screen, the system: 


• 
accepts your valid entries and responds immediately to your input 


• 
rejects your invalid entries and responds automatically by either 
reporting the error or skipping over an attribute 


The paging prompt: 


[N]ext page, [P]rev page, [A]dd line, or number: 


allows you to select an operation mode for the field data entry 
screen. 


WHEN you want to... 
THEN select... 
display the next page of fields 
n (next page) 
display the previous page of fields 
p (previous page) 
add new fields 
a (add line) 
display the page with the indicated field, and 
1-256 (number) 
position the cursor at that field 
terminate the field entry screen and redisplay 
CfRLU 
the record type entry screen 


The field entry screen has the following prompts. 


CD 
RECORD. The name of the record type whose fields you're 
adding or modifying. This is a display only prompt. 


® 
LN (Line Number). A line number the system assigns. Use 
this number to reference the field definition you want to access. 


® 
CMD (Command). This is where you enter an operation 
command. The cursor marks the position of the current 
definition. The valid operation commands are as follows. 
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WHEN you want to... 
THEN select... 
modify KEY, REF, TYPE, LEN, LONG 
m (modify) 
NAME, or COMB. FIELD for the current 
field 
delete the current field 
d (delete) 
renumber the current field and reorder the 
1-256 (number) 
fields on the screen 
redisplay the paging prompt at the bottom of 
q (quit) 
the screen 


o 
FIELD. This is a unique eight character field name. The name 
can contain letters (upper and lower case), numbers, and the 
underscore character (_). It must begin with a letter. 


® 
KEY. An asterisk in this column indicates that the current field 
is the primary key of the record type. 


® 
REF. The name of the primary key for another record type. 
The system uses this to establish an explicit relationship with 
another record type. 
o TYPE. This is the data type of the field. You only need to 
enter the first letter of the type. The valid data types are as 
follows. 


LETTER 
DATA TYPE 
n 
NUMERIC 
f 
FLOAT 
s 
STRING 
d 
DATE 
t 
TIME 
a 
AMOUNT 
c 
COMB 


® LEN (Length). This is the default display length of the field 
on screen forms and reports. 


For NUMERIC and STRING fields, enter the length of the 
display in characters. 


For FLOAT fields, use the form nnd. nn indicates the number 
of display positions, including the decimal point; and d 
indicates the number of digits right of the decimal point. 
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EXAMPLE: 
A FLOAT field with a LEN of 123 has a default format 
of: 


nnnnnnnn.nnn 


A FLOAT field with a LEN of 100 has a default format 
of: 


nnnnnnnnnn 


Notice there is no decimal point. The format, then, 
consists of ten digits. 
For AMOUNT fields, enter the number of digits left of the 
decimal point. The system assumes the two digits right of the 
decimal point. 
EXAMPLE: 


An AMOUNT field with a LEN of six looks like: 


nnnnnn.nn 


The total display length of AMOUNT fields is LEN+3. 
The maximum allowable length of each data type is as follows. 


DATA TYPE 
LENGTH 
NUMERIC 
9 
FLOAT 
179 
STRING 
256 
DATE 
ilja: defaults to 8 
TIME 
nja: defaults to 5 
AMOUNT 
11 
COMB 
nja: system calculated 


® 
LONG NAME. This is a more descriptive field name of 16 
characters. The name can contain letters (upper and lower 
case), numbers, and the underscore character (_). It must 
begin with a letter. SQL and RPT use this name to identify 
fields. 


@ 
COMB. FIELD (Combination Field). The name of a COMB 
field in the current record type that this field becomes a part of. 
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Entering a Field Definition 


o 
STEP 
5: 


Action: 


Effect: 


[dbcreate] 
[A]DD 


RECORD: ..anf 


Select add mode. 
Enter an a at the paging prompt. 


The cursor moves to the FIELD column. 


UNIFY R.l•••• 3.2 
10 JAN 1985 _ 14:22 


Design an4 Create a Hew Data Base 


LN 
ClID 
FIELD 


IlI8no 


KEY 
REF 
TYPE 
LEN 
LONG NAME 


NUMERIC 4 
••nufactur.r_ID 


COMB. FIELD 


0 
STEP 
6: 
Define the primary key field for the manufacturer 
record. 


Action: 
Enter the definition as shown. 


Remember to press IRETURNI after each entry. 


Note: 
When you enter the field's long name, the cursor 
moves to the KEY column, not the COMB. FIELD 
column. 


This is because UNIFY is ensuring a valid data 
base design. 


When an entry for a field is not valid, the cursor 
automatically skips a column. 


In this case, the primary key of a record type 
cannot be a sub-field of a COMB field. The 
cursor, then, skips the column. 


0 
STEP 
7: 
Move the current field definition to the paging 
area. 


Action: 
Press ICTRU IQ] with the cursor in the KEY 
column. 
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RECORD: ..nf 


Effect: 
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The field entry area clears so you can add another 
field. The current definition moves to the paging 
area and the system assigns it a line number. 


UNIFY Rde...e 3.2 
10 JAJ{ 1985 _ 14:22 
Design and Crea.te a. Nev Da.ta Baa. 


LN 
CMD 
PIELD 
• 


KEY 
REP 
TYPE 
LEN 
LONG NAME 
COMB. 
PIELD 


1 
2 
3 


..no 
.name 
..dd 


KUMERIC 4 
.anufacturer_ID 
STRING 
30 
Aame 


STRING 
30 
4ddre•• 


o 
STEP 
8: 
Complete the field definitions for the 
manufacturer record type. 


Action: 
Enter the field data for mname and madd as 
shown. 


Correcting Mistakes 


When you want to correct the name of a field in the paging area, 
you must delete the field and then add it again. 


When you want- to make other corrections: 


1. 
Enter the line number of the field you want to modify at the 
paging prompt. 


2. 
Enter an m in the CMD column. 


3. 
Press IRETURNI to move to the column you want to change. 


4. 
Make the correction. 


S. 
Press either IRETURN1 or ICTRLI Kll to move back to the KEY 
or REF column. 


6. 
Press ICTRLI Kll to redisplay the paging prompt. 
o 
STEP 
9: 


Action: 


Return to the record type entry screen. 


Press ICTRLI Kll until the record type entry screen 
displays. 


2-13 


UNIFY Tutorial 


Effect: 
The paging prompt displays with the cursor at the 
prompt. Then, the record type entry screen 
displays with the cursor in the RECORD column. 


[dbcr...te] 
[A]DD 


UNIFY Roloa.o 3.2 
Desiqn and. Create" Hev Data. BAs8 


10 JAN 1985 _ 14:22 


LN 
CMD 
RECORD 
• 


EXPECTED 


10 


LONG NAME 


...nu!acturer 


DESCRIPTION 


Note: 
The manufacturer record type definition with its 
assigned reference number is now in the paging 
area. 


[dbcr...te] 
[A]DD 


UNIFY Roloa.o 3.2 


O••iqn And Create" Hev 
Da~a Baa. 


1Q JAM 1985 - 
14:22 


LN 
CMD 
RECORD 
EXPECTED 


m04al 
50 


10 


LONG NAME 


_01 


aanufacturer 


DESCRIPTION 
• 
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o 
STEP 10: 
Action: 
o 
STEP 11: 
Action: 


Effect: 


Define the model record type. 
Enter the modei data as shown. 


Display the field entry screen. 
Press IREtURNI with the cursor in the 
DESCRIPTION column. 
The field entry screen displays. 


Designing and Creating a New Data Base 


[dbcroatoj 
[A]DD 


RECORD: 
modal 


OKIFY Rolo••o 3.2 
O••iqn and Create & Mev Data Baa. 
10 JAN 1985 _ 14:22 


LN 
CMD 
FIELD 
KEY 
REP 
TYPS 
LEN 
LONG IIAM.S 
COMB. 
FIELD 


mokay 
COMB 
Modol-Xoy 


o 
STEP 12: 
Action: 


o 
STEP 13: 


Action: 


Effect: 


Add the primary key field definition for model. 
Select add mode at the paging prompt and enter 
the field definition as shown. 


Move the mokey definition to the paging area. 
Press ICTRLI [U with the cursor in the KEY 
column. 
The field entry area clears and the definition 
moves to the paging area. 


[dbcro.to] 
[A]DD 


RECORD: .odal 


UNIFY Rolo••o 3.2 


O••19"!1 and Cr.ate a Mev Data Baa. 
10 JAN 1985 _ 14:22 


( 
LN 
CMD 
PIBLD 


1l0UUIl 


XSY 
RSP 
• 


TYPS 
LSII 
LONG NAMS 


IlUllBlUC 7 
Modol-llumber 


COMB. 
FISLD 


aokey 


aokey 
COMB 
aodol-Xoy 


( 
o 
STEP 14: 


Action: 
o 
STEP 15: 


Action: 


Effect: 


Define the first sub-field of mokey. 


Enter the field definition as shown. 


Move the definition to the paging area. 


Press ICTRLI [U. 


The screen displays as follows. 
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[dbcreate] 
[A]DD 


RECORD: model 


UNIFY Releass 3.2 


Oesiqn and Create 
4 
Hev Data Base 


10 JAN 
1985 
- 
14:22 


~N 
CMD 
FIELD 
• 


KEY 
REF 
TYPE 
LEN 
LONG KAME 
COMB. 
FIELD 


mokay 
manum 


COMB 
IlUMERIC 7 


ModeLKey 
IIodeLNumber 


Note: 
The monum field indents automatically to show 
that it is a component of the mokey field. 


[dbcuate] 
[AJDD 


RECORD: .odd 


UNIFY R.I•••• 3.2 


Design And CreAte 
8. Hew Data Ba•• 
10 JAN 1985 _ 14:22 


LN 
ClID 
FIELD 
KEY 
REF 
TYPE 
LEN 
LONG NAME 
COMB. FIELD 


momano 


.okey 


.onum 


..no 
II1lMERIC • 


COMB 
II1lMERIC 7 


Xanufacturer_ID 


AodeLKey 
ModaLNumber 


.okey 
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o 
STEP 16: 
Action: 


Note: 


o 
STEP 17: 


Action: 


Add the next sub-field of mokey. 


Enter the field definition as shown. 
The momano field also references the primary key, 
mano, of the man! record type. This establishes 
an explicit relationship between man! and model. 


The values for the TYPE and LEN columns derive 
from the manufacturer record field, mano, and 
automatically display on the screen. 


Move the new definition to the paging area. 


Press ICTRLI ill]. 


Designing and Creating a New Data Base 


(dbcreato] 


RECORD: 
mode~ 


UNIFY 
Re~e.8e 3.2 


Deaiqn And Create 
11 Hew Data BAa. 
10 JAN 1985 - 
14:22 


LN 
CMD 
FI:ELD 
KEY 
REF 
TYPE 
LEN 
LONG KAME 
COMB. 
FIELD 


1 


2 
3 
4 


mokey 


monum 
momano 


mde. 


mano 


COMB 
IlUMERIC 7 
Il1.lMEllIC 4 
STRING 
30 


ModeLKey 
JlodeLNwnber 
Manufac'tU%er_ID 
Description 


(N]ext paqe, 
[P]rev paqe, 
(A]dd line, or nwnber: 
• 


(~ 


o 
STEP 18: 


Action: 


o 
STEP 19: 


Action: 


Add the remaining field, rodes. 


Enter the definition as shown. 


Terminate add mode and return to the record type 
entry screen. 


Press ICTRLI IDl to display the paging prompt and 
to exit the record entry screen. 


[dbcre.te] 
(A]DD 


UNIFY Rele.ae 3.2 
Design a.nd Crea.te 
& Hew Data BA88 
10 JAN 1985 _ 14:22 


LN 
CMD 
RECORD 
EXPECTED 
LONG NAME 
DESCRIPTION 


item 


_nf 


.ode~ 


100 


10 
50 


aanufacturer 
.odd 


• 


o 
STEP 20: 


Action: 


Define the next record type. 


Enter the item definition as shown. 
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o 
STEP 21: 


Action: 


(dbcr...te] 


ltECORD: ite.. 


Move to the field entry screen. 


Press IRETURNI with the cursor in the 
DESCRIPTION column. 


UNIFY 1...1..... 3.Z 
10 JAH 1985 _ 14:.. 


D••iqu &n4 Create 
4 Hev Data Baae 


LN 
CMD 
FIELD 
ICEY 
REP 
TYPE 
LEN 
LONG NAlIE 
COMB. 
FIELD 


1 


Z 
3 
4 


ano 
!madel 
i ..d 
i841 


WU!lERIC 9 
.ok.y 
COMB 


DATE 
AlIOIlll'l' 
5 


lSeri..LNUlIlb.r 
.ad.LID 
.cqui.ition-D..te 
lS.lea_Price 


(N).xt p ..~e, (P]rev p..~e, [A]dd line, or nUlllber: _ 
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o 
STEP 22: 


Action: 
Note: 


o 
STEP 23: 
Action: 


Define the fields for the item record type. 
Enter the definitions as shown. 
This is how the field entry screen looks when you 
complete the entries. 


Return to the record type entry screen. 
Press ICTRLj ID]. 


Designing and Creating a New Data Base 


[dbcreate 1 
UNIFY aeleese 3.2 


Oesiqn and Create 
4 
New Data Baa. 
10 JAN 1985 - 
14:22 


LN 
CMD 
RECORD 
EXPECTED 
LONG NAME 
DESCRIPTION 


m&nf 
moc1el 
item 


10 
50 
100 


manufacturer 
model 
inventory_itam 


[NJext paqe. [PJrev paqe. 
[AJdd line. or number - 


o 
STEP 24:· 
Terminate add mode. 


Action: 
Press ICTRU IQ] with the cursor in the RECORD 
column. 


( 


Effect: 


Reason: 


The paging prompt redisplays. 


You're ready to create an initial data base. 


2.3 CREATING AN INITIAL DATA BASE 


The second phase of Design and Create a New Data Base allows you 
to: 


• 
print a report of the data base design 


• 
create an empty data base using the new design 


• 
create data entry screens 


• 
create a data entry menu 
The result of the first and second phases is a prototype application. 


You can perform these operations in several ways; this subsection 
shows you how. You begin this phase by ending the first phase. 
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o 
STEP 25: 


Action: 


Effect: 


End the data base design phase. 


Press ICTRU IQ]. 


A message displays on the screen as follows. 


[dbcroate) 
UNIFY Rele4se 3.2 


Design and Create 4 Kew 
D4t~ Baae 
10 JAli 1985 - 
14:22 


LN C!oID RECORD 
EXPECTED 
LONG NAME 
DESCRIPTION 


&4nf 
sode1 
.item 


10 
50 
100 


aanufacturer 
aodel 
.inventory_item 


You have now finished enterinq your data baae design. 
If you Yould 
l~k. 


to automatically print the design. create the data bAse, data entry acr••ns 
and & ••nu. type 
~y'. 
~p. 'n' to return to the ••nu. 
Proceed?_ 


WHEN you want to... 
THEN enter... 
end Design and Create a New Data Base and 
n (no) 
redisplay t):1e active menu 
display the four application development 
y (yes) 
options 
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o 
STEP 26: 


Action: 


Effect: 


Display the four application development options. 


Enter a y. 


The development option prompts display. 


CD 


Print Data Bas8 Design 7 
(.J 


Create Data Entry Scre.ns ? [ J 


CD 


-" 
Designing and Creating a New Data Base 


o 
create Data BAse ? 
Create Menu?o 


( 
" 


( 


(,.. 


Type 'y' 
to 8elect An option. 'n' 
to ignore one. 


To select the development options: 


1. 
Enter a '<y" (yes) or an "n" (no) to indicate each response. 


2. 
Move the cursor from one option to another by pressing 
IRETURNI. 


3. 
Answer each prompt to progress. You cannot move backward 
in the selections. 


Each development option is as follows. 


CD 
Print Data Base Design? 


This option tells dbcreate to print a list of the current data base 
design. The report includes: 


• 
all record types, fields, and their relationships 


• 
an alphabetical cross reference of the fields 


• 
the size parameters of the qata base 
The report is 79 characters wide. For an example of its output, 
see the beginning of this section. 


When this operation is in progress, the following message 
displays. 


The data base design is being formatted for printing. 


® 
Create Data Base? 


A yes answer to this option tells dbcreate to create an empty 
data base file from the current design description. The 
program compiles and writes the design to a file called file.db. 


A no answer to this option causes the system to skip the last 
two options. 
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When you select this option, the program automatically creates 
an empty data base file. Consequently, the precautions you 
should take are as follows. 


• 
Make sure no one is using this UNIFY application before 
starting and running dbcreate. 


• 
Check for valuable information in the data base. 
Remember, when dbcreate finishes, the data base is empty. 
If there is valuable information, see Section 6.10 on 
transferring the data to an ASCII file using SQL. After the 
empty data base completes, see Section 6.11 on reading the 
data back into the data base. 


® 
Create Data Entry Screens? 


A yes answer to this option tells dbcreate to create, process, 
and register with ENTER a data entry screen form for each 
record type. (For complete information on ENTER, see the 
UNIFY Reference Manual, Section 4.2.) 


A no answer to this option tells the system that you want to 
create screen forms for the data base using Create Default 
Screen Form, Check Screen Form Coordinates, or Paint Screen 
Forms. (See the UNIFY Reference Manual, Sections 4.9, 4.4, 
and 4.1, respectively.) 


As this operation progresses, the following message displays for 
each record type. 


Creating data entry screen for: xxxxx 


The variable xxxx:x is the name of the current record type that 
identifies the default screen form. 


o 
Create Menu ? 
The program allows this option only when you select the Create 
Data Entry Screens? option. The program creates a menu 
called "Data Entry Screens" (usermenu) and adds it as the last 
menu line of the UNIFY Main Menu. This new menu contains 
a selection option for each of the default screen forms it 
created. 
Each time you select this option, the program recreates the 
Data Entry Screens menu. Consequently, any previous changes 
made to usermenu using Add, Modify, or Delete Menus are 
lost. 
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As this operation progresses, the following message displays for 
each record type. 


Creating data entry screen and menu entry for: xxxxx 


The variable xxxxx is the name of the current record type that 
identifies a default screen form and menu entry. 


Print Data Ban D..i9'n ? 
(y] 
Craato Data Ban? (y] 
Cr.ate Data Entry Scr••na ? 
[y] 
Create Menu? 
[y] 


Are th••• choice. ok? • 


o 
STEP 27: 


Action: 


Effect: 


o 
STEP 28: 


Action: 


Effect: 


Select all the development options. 


Enter a y (yes) as your response to each prompt. 


The program (dbcreate) asks you to verify your 
selections as follows. 


Are these choices ok? 


Verify your selections. 


Enter a y (yes) to continue. 


As the system compiles the data base design, the 
screen displays the following messages. 


Selecting, 
Sorting, 
and 
Formatting. 


The data base design report is sent to the printer. 
Before the system creates the empty data base, the 
following message displays. 
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A 
~ew. 
empty data bAse is about to be created. If you have 


:~formation in an existinq dAta baa., it vill be lost. 
No 
one else 
8ho~d be using the dAta b&8. at this time. 


P?OCEED? • 


o 
STEP 29: 


Action: 


Reasqn: 


Effect: 


•• Phase I 


_.. PhAse II 


Verify that you want to create an empty data 
base. 


Enter a y (yes) to proceed. 


A "no" answer terminates dbcreate. 


When the system creates the data base, the 
following message displays. 


o 
STEP 30: 


Action: 


Effect: 
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Continue the data base creation. 


Press IRETURNI. 


As the system creates the data entry screens, 
registers the screens with ENTER, and adds menu 
lines to each screen form, the screen displays the 
following messages. 


Selecting, 
Sorting, 
and 
Formatting. 


When the process completes, the following 
message displays. 


Designing and Creating a New Data Base 


Crea~inqdata 
entry scr.eu and menu entry for: 
item 


o 
STEP 31: 


Action: 


Effect: 


Continue the data base creation. 


Press IRETURNI. 


The UNIFY Main Menu redisplays with your new 
menu, Data Entry Screens, in place. 


[lllAinmanu] 
ONIFY R.l.aa. :.2 
UNIFY Main M.nu 
10 JA)l 1985 - 
14:22 


SELECTION: 8. 


1·:,"'~JJ7~ 


2. Create or Modify Screena 


3. SQL - Quary/DM.t. Lanquaq. 


4. Edit: SQL or RPT COlllJll&nd FUu 


5. Add. Modify or Dalat:a Manua 


6. Dat:a Ba•• D••iqn 0t:i1it:ia. 


7. Sy.t:am Admini.t:rat:ion 


a. Data Entry Scre.ns 


" 
':<w 
--;;;;;-- 


~~,,;,,".m.,..•-:.•.y,,..• 


l 


Note: 
The "Data Entry Screens" option is available. 


2-25 


UNIFY Tutorial 


o 
STEP 32: 


Action: 


Effect: 


Select the Data Entry Screens (usermenu) option. 
Make your selection by either: 


entering an 8, "Data Entry Screens," at the 
selection prompt, or 


moving the menu pointer to menu line 8 and 
pressing your select command key. 


Your newly createrl menu displays as follows. 


[user••nul 
UNIFY Rele.ee 3.2 
Data Entry Scre.ns 


2. Model Maintenance 


3. 
Inventory It•• Maintenance 


10 JAN 1985 - 
14:22 


You're now ready to add records to the new data base. 
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Adding Data with ENTER 


(- 
3. ADDING DATA WITH ENTER 


For each record type you created in Section 2, there is now a data 
entry, or ENTER, screen. 


This section instructs you how to add test data for each record type. 
The information you enter here allows you to query, or request 
information, and generate reports in later sections. 
When you select the Data Entry Screens (usermenu) option from the 
UNIFY Main Menu, the new menu displays with the ENTER screen 
options. From this menu, you can select the options that allow you to 
add manufacturer, model, and item records. 
o 
STEP 
1: 


Action: 


Effect: 


Select the "Manufacturer Maintenance" option 
from the Data Entry Screens menu. 
Enter a 1.. 


The Manufacturer Maintenance (man!) screen 
form displays. 


[lIlAnf] 


Manutacturer ID: 
Ham. 
Ad4r••• 


UKlFY R&l&••& 3.2 
Manufacturer Maintenance 


10 JAN 1985 _ 1':22 


[I)HQUIllZ. 
[A]DD. 
[M)ODIFY. 
[D]l!:Ll!:'I'E • 
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The appearance of this screen form reflects the data base design you 
entered in Section 2. "Design and Create a New Data Base" did all 
the work of designing, building, and making the form accessible by 
. the Menu Handler. 


ENTER screens reference a single primary record type. You can 
add, delete, modify, or inquire records of one type using its screen 
form. 


ENTER screens can also reference secondary record types, displaying 
fields from these other record types. This ability lets you form a 
"view" of the data base. 
For ENTER to work properly with secondary record types, there must 
be an explicit relationship between the primary and secondary record 
types. The data base design establishes this relationship. 


The operation prompt: 


[I]NQUIRE, [A]DD, [M]ODIFY, [D]ELETE 


allows you to select inquire, add, modify, or delete mode. 


In add mode, you can add new records of the primary record type. 
You accomplish this by assigning a primary key value. When the 
primary key is a COMB data type, each component of that field 
must be assigned a value. 
In inquire, modify, and delete modes, you can select records by 
entering field value(s) on the screen form. ENTER then searches for 
records that match the logical "and" of the field values. For 
information on this search and select process (called Query By 
Forms), see Section 9. 
Your system administrator can cQntrol the authority to use a screen 
form, and the security of the operation modes within a form. For 
infotmation on setting individual user and group privileges, see 
. Section 13. 
Positioning the Cursor on the Screen Form 


The cursor moves to the first prompt on the screen form when you 
choose an operation mode. 


WHEN you want to move the cursor... 
THEN press... 
down the screen 
RETURN 
up the screen 
crRLU 


3-2 


( 
. 


( 


Adding Data with ENTER 


WHEN you want to... 
THEN press... 
return the cursor to the first screen 
RETURN or 
field 
CfRLU 
clear the screen for the next operation 
CfRL U at the first 
screen field 
redisplay the operation prompt at the 
CfRL U again at the 
bottom of the screen form 
first screen field 
exit from the screen form back to the 
CfRL U at the 
Menu Handler 
operation prompt, or 
CfRL X anywhere 


Changing the Field Values 
To change the value of a primary record field: 


1. 
Position the cursor at the screen prompt. 


2. 
Enter the new value, then press IRETURN!. . 
If the system accepts the change, the information is stored in the 
data base. The cursor then moves to the next prompt. 
If the system rejects the change, an error message displays at the 
bottom of the screen. The information is not stored in the data base. 
Press IRETURNI to acknowledge the error message, and try again. 
If you start to enter information and decide to change it, a ICTRL! 
ill! aborts the entry without altering the data base. 
To change the value of fields in a secondary record type, you must 
use the data entry screen form for that record type. If you want to 
update multiple record types using the same screen form, you must 
write a custom program. More information on this subject can be 
found in the UNIFY Programmers' Manual. 


Adding Manufacturer Records 


o 
STEP 
2: 
Action: 
Effect: 


Select add mode. 
Enter an a at the operation prompt. 
The cursor moves to the first screen field. 
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(manf] 
(A]DD 


UNIFY Releas. 3.2 


ManUfacturer Maintenance 


10 
JJtJl 
1985 
- 
14: 22 


Manufacturer to: 
JOO 
Name 
: _ 
Smith Manufacturing- 


Address 
: 
~3 Galveston '£'ve. 


o 
STEP 
3: 


Action: 


o 
STEP 
4: 


Action: 


Effect: 


o 
STEP 
5: 


Action: 


1D Name 


Add a manufacturer record. 
Enter the first manufacturer record as shown. 


Remember to press IRETURNI after each field. 


Clear the screen of data. 
Press ICTRLI ITlJ with the cursor at the first 
screen field. 


You're ready to add more manufacturer records. 


Add five more manufacturer records. 


Enter the ID, name, and address of each record as 
follows (note that you have already added the first 
one): 


Address 


100 RH Smith Manufacturing 
101 Precision Tool Co. 
102 A & H Industries, Inc. 
103 Grover Parts and Supplies 
104 The Tool Depot 
105 BHP Ltd. 


523 Galveston Ave. 
2600 West 16th Street 
2434 Evergreen Ave. 
9462 Jackson Road 
7562 Orange Dr. 
17385 Weatherby Rd. 
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o 
STEP 
6: 
Action: 


Return to the Data Entry Screens menu. 


Press ICTRLI lXJ to return to the menu. 


( 


[uaermenu] 


SELECTION: mod.l- 


UNIFY R.l•••• 3.2 
DAta Entry Screens 


2. Mod.l M.int.nanc. 


3. 
Inventory Item Maintenance 


Adding Data with ENTER 


10 JAN 1985 _ 14:22 


Adding Model Records 


o 
STEP 
7: 


Action: 


Effect: 


Select the "Model Maintenance" option. 


Enter the name of the screen form, model, at the 
selection prompt. 


The screen form displays. 


[model] 
[A]DD 


Mod.l Numb.r 
Manufacturer I D: 
D••eription 


UNIFY Relea•• 3 .2 
Model M.intenanee 
10 JAN 1985 _ 1 4: 22 
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o 
STEP 
8: 


Action: 


Add the model records. 


Enter the model number, manufacturer ID, and 
description of each record as follows: 


Model 
ID 
Description 
----------------------------------- 
1001 
100 
1/2' , socket wrench 


1002 100 
3/4' , socket wrench 
1003 100 
1/2' , open end wrench 


55071 
101 
1/2' , socket wrench 
55171 
101 
1/2' , box end wrench 


55271 
101 
combination pliers 
55371 
101 
needle nose pliers 


1001 
10Z 
vise grips 
1002 102 
leather mallet 


61117 103 
3' • Phillips screwdriver 
71117 103 
3' • slotted screwdriver 
81117 103 
6' , Phillips screwdriver 
91117 
103 
6' • slotted screwdriver 


1011 
104 
combination pliers 


1012 104 
1/2' , socket wrench 


o 
STEP 
9: 
Action: 


Return to the Data Entry Screens menu. 


Press ICTRLI lKl to return to the menu. 


Adding Item Records 
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o 
STEP 10: 


Action: 
Effect: 


Select the "Inventory Item Maintenance" option. 


Enter a 3. 
The screen form displays. 


I· 


(it.m] 
(A]DD 


Serial 
!t1mber 
M.anufacturer 
10 
Model 
lbmll.r 


ACquisition rat.: 
sale. 
Price 


o 
STEP 11: 
Action: 


Note: 


Adding Data with ENTER 


UfIFY 
llIl00.se 
3.2 
Invent;ory Item Mlintena.ne. 


Add the item records. 
Enter the serial number, manufacturer ID, model 
number, acquisition date, and sales price of each 
record as follows: 
You can enter the dates quickly with the numeric 
key pad. Use "." instead of "I" as the separator. 
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4. Modifying a Data Base Design 
4.1 Modifying Record Types 
4-4 
4.2 Printing a Data Base Design Report 
4-15 
4.3 Reconfiguring the Data Base 
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4. MODIFYING A DATA BASE DESIGN 


With the record types you created in Section 2 and the data you 
added in Section 3, you now have an inventory system. 


The inventory system as it now stands is suitable only for keeping 
track of current items. But, suppose you want to create orders for 
customers, print order forms, and track the difference between the 
purchase price and the sales price. 


You must add new record types and fields to your data base design. 
This section shows you how to: 


• 
modify the data base design 


• 
print the data base design 


• 
reconfigure the data base 
The new record types you will be adding to the data base are as 
follows: 


RECORD/FIELD 
REP' 
TYPE 
LEN 
LONG NAME 


customer 
10 
customer 
"cnWII 
NUMERIC 
5 
CUstomer-Number 


cname 
STR:ING 
30 
Name 


eaddr 
STR:ING 
30 
Address 


eeity 
STR:ING 
20 
City 
estate 
STR:ING 
2 
State 
ezip 
STRING 
5 
Zip_Code 


ephone 
STR:ING 
14 
Phone..Number 


orders 
100 
orders 
·onum 
NUMER:IC 
9 
Order..Number 
odate 
DATE 
Date_Ordered 
ocust 
cnWII 
NUMER:IC 
5 
Customer..Number 


As for the record type modifications, you will: 


• 
add three address fields to the manufacturer record type (manf) 
for a more realistic address capability 


• 
extend the manufacturer name field to allow for new 
manufacturers with longer names 


• 
modify the item record type to allow for order number and 
purchase price fields 


( 
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The fields to modify and add to the existing record types are as 
follows: 


RECORD: manf 


Modify fields: 
roname 


Add fields: 
mcity 
mstate 
mzip 


RECORD: item 


STRING 


STRING 
STRING 
STRING 


3S 
Name 


20 
City 
2 
State 
S 
Zip-Code 


Add fields: 
iorder 
ipamt 
onlUll 
NUMERIC 
9 
Order-Number 
AMOUNT 
S 
Purchase-Price 


c. 


Once you make the appropriate changes, here's what the complete 
data base design looks like. 
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DATA"DICTIONARY REPORTS 


Data Base Design 


RECORD/FIELD 
REF 
TYPE 
LEN 
LONG NAME 
manf 
10 
manufacturer 
-mano 
NUMERIC 
4 
Manufacturer_ID 
lDIlame 
STRING 
35 
Name 
madd 
STRING 
30 
Address 


mcity 
STRING 
20 
City 
mstate 
STRING 
2 
State 
mzip 
STRING 
5 
Zip_Code 


mo<1el 
SO 
mo<1el 


-l1IOkey 
COMB 
Mod.el-Xey 


I1IOnum 
NUMERIC 
7 
Mod.eL.Number 
l1lOmano 
mano 
NUMERIC 
4 
Manufacturer_ID 


m<1es 
STRING 
30 
Description 


item 
100 
inventory_item 
-sno 
NUMERIC 
9 
Serial_Number 
imo<1el 
l1lOkey 
COMB 
Mod.el_ID 
iad 
DATE 
Acquisition-Date 


isal 
AMOUNT 
5 
Sales-Price 


iorder 
onum 
NUMERIC 
9 
Order-NUmber 
ipamt 
AMOUNT 
5 
Purchase-Price 


customer 
10 
customer 
-cnum 
NUMERIC 
5 
Customer-NUmber 
cname 
STRING 
30 
Name 


caddr 
STRING 
30 
Address 


ccity 
STRING 
20 
City 
cstate 
STRING 
2 
State 
czip 
STRING 
5 
Zip_Code 


cphone 
STRING 
14 
Phone-NUmber 


orders 
100 
orders 
·onnm 
NUMERIC 
9 
Order-NUmber 
o<1ate 
DATE 
Date_Ordered 
ocust 
cnum 
NUMERIC 
5 
Customer-NUmber 
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-t.! ivIODIFYING RECORD TYPES 


In this subsection, will make all the data base design chang~s. This 
includes adding the new record types customer and orders, as well as 
modifying the existing manf and item record types. 


( 
. 


[usermenu] 
UNIFY a.l•••• 3.2 
Data Entry Scre.ns 


1. Manufacturer Maintenance 


2. Ilodel Ilaint.nanc. 


10 JAN 1985 - 
14:22 


o 
STEP 
1: 


Action: 


Effect: 


-1--4 


Select the "Data Base Design Utilities" menu. 


Enter the name of the menu, dbdesign, at the 
selection prompt as shown. 


You move directly from your active menu, Data 
Entry Screens, to the "Data Base Design Utilities" 
menu. 


[dbdeaiqu] 


SELECTION: 
1. 


UIlIF'Y ble.a. 3.2 
Data Baa. Deaiqn utilitiea 


2. 
Print Data Baa. Deaiqu 


3. 
Cr••t. Dat. Baa. 


". Writ. Data Baa. Backup 


5. !18confiqur. Data Baa. 


6. 
M4, Drop 11-'1'%•• In4.xea 


7. Mv.nc.4 11d4 Atuibutea 


Modifying a Data Base Design 


10 JAN 1985 
_ 
14: 22 


o 
STEP 
2: 


Action: 
Effect: 


Select the "Modify Data Base Design" option. 
Enter a 1 as shown. 
The screen form displays as follows. 


[ech.nt] 
11KIF'Y !l.l••a. 3.2 


M04ify D.t. B.a. Daaiqu 


10 JAN 
198~ _ 14:22 


LX 
CMD 
llECOllD 
EXPECTED 
LONG HAMB 
DESCllIP'!'ION 


1 
2 
3 


IIl&nf 
m04el 
item 


10 
SO 
100 


DlAnufactur.r 
m04al 
inv.ntory_item 


[N]axt 
paqa, [P]rev paqa, [A]44 lin., or numb.r: •• 
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o 
STEP 
3: 


Action: 


Note: 


Select add mode. 


Enter an a at the operation prompt. 
This screen form is the same as the record type 
entry screen you used in "Design and Create a 
New Data Base," Section 2. 


[.chent] 
[A]DD 


UNIFY Releaae 3.2 
Modify Data Baae Deaiqn 


10 JAN 1985 _ 14:22 


LN 
CMD 
RECORD 
EXPECTED 
LONG KAME 


cuat.omer 
10 
cuatom.er 


DESCRIPTION 
- 


IIl4nf 
model 
item 


10 
50 
100 


m.anufacturer 
model 
invent.ory_item 


( 


o 
STEP 
4: 


Action: 


Effect: 


Add the customer record type. 
Enter the record type definition as shown, then 
press IRETURNI. 
The field entry screen displays. 


[achent] 


'RECORD; cuatomer 


UNIFY Releaae 3.2 
Modify Data Baae Deaiqn 


10 JAN 1985 _ 14:22 


LN 
CMD 
FIBLD 
Il:EY 
REP 
TYPB 
LEN 
LONG !IAMB 
COMB. 
FIELD 
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[N]ext pege, [P]rev pege, 
[A]dd line, or number: a- 


o 
STEP 
5: 


Action: 
Note: 


Modifying a Data Base Design 


Select add mode. 
Enter an a at the paging prompt. 
This screen form is the same as the field entry 
screen you used in "Design and Create a New 
Data Base," Section 2. 


[sehent] 


RECORD: 
custom.er 


UNIFY R.leas. 3.2 
Modify Data Ba.. O.eiqn 
10 JAN 1985 _ 14:22 


LN 
CMD 
FIELD 
Ja:Y 
REP 
TYPE 
LEN 
LONG !lAME 
COMB. 
FIELD 


1 
2 
3 
4 
5 


6 


7 


enum 
ename 
caddr 
eeity 
esta.te 
ezip 
cphone 


II1lMERIC 5 
STRING 
30 


STRING 
30 


STRING 
20 


STRING 
2 


STRING 
5 


STRING 
14 


Customer_Number 


Hame 
Addr••• 
City 
Sta.t. 
Zip-Code 
Phone_Number 


[N]ext paq., [P]rev peqe, 
[A]dd lin., or number: 
- 


o 
STEP 
6: 


Action: 


o 
STEP 
7: 


Action: 


Effect: 


Add the fields for customer. 
Enter the field definitions as shown. 


Return to the record type entry screen. 
Press ICTRLI ill] when you finish adding the 
customer field definitions. 


The cursor is at the paging prompt as shown. 
The record type entry screen displays. 
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[achant] 
UIlIFY lllIlaaaa 3.2 
10 
JAN 1985 - 
'1-4: 22 
[AJOO 
Modify Data Ban Da.ign 


LN 
010 
RECORD 
EXPECTED 
LONG NAME 
DESCRIPTION 


orders 
100 
orders 
• 


1 
.ant 
10 
...nufacturer 
2 
.:>del 
50 
.,del 


3 
itam 
100 
invantory_item 


4 
cuatomer 10 
cua't.omer 


o 
STEP 
8: 


Action: 


o 
STEP 
9: 
Action: 
Reason: 


Add the orders record type. 
Enter the record type definition as shown. 


Move to the field entry screen. 


Press IRETURNI. 
You're ready to add the new fields for orders. 


[.chent] 
[A]DD 


RECORD: order. 


UNIFY aelea.8 3.2 
lIodify Data Ba.a Da.ign 
10 JAN 1985 _ 14:22 


LN 
CIID 
FIELD 
• 


Ja:Y 
REI' 
TYPE 
LEN 
LONG NAlIE 
COIlB. 
FIELD 


1 


2 
3 


on.... 
odate 
ocua't 
cn.... 


ll1lMERIC 9 


DATE 
ll1lMERIC5 


Ord.er_Humber 
Dat...Ordered 
Cuatomer_Humber 


4-8 


o 
STEP 10: 
Action: 
o 
STEP 11: 


Action: 


Add the fields for orders. 
Enter the field definitions as shown. 


Return to the record type entry screen. 


Press ICTRL! illJ until the record type entry screen 
displays. 


[sch.ntJ 
UllIFY Rel.... 3.2 


Mo4ify Dat. Ba.. D..iqn 


Modifying a Data Base Design 


10 JAIl 1985 _ 
14: 22 


LN 
OlD 
m:CORD 
EXPECTED 
LONG lIAIIE 
DESCRIPTION 


1 
_nf 
10 
...nufacturer 


2 
.odd 
50 
.ode! 


3 
it... 
100 
i.nv.ntory_it... 


4 
cuatomer 10 
customer 


5 
orders 
100 
orders 


[NJ.n Jl8q.. 
[PJr.v Jl8q.. 
[.\J44 lin•• or numb.r 1. 


o 
STEP 12: 
Action: 
Reason: 


Effect: 


Access the man! record type. 
Enter a 1 as shown. 


You're ready to modify the fields for the record 
type, man!. 


The cursor moves to the specified line in the OlD 
column. 


[sch.ntJ 
UNIFY R.l•••• 3.2 


Mo4ify D.ta B... D••iqn 


10 JAIl 1985 - 
14:22 


LN 
CMD 
RECORD 
EXPBCTED 
LONG HAMZ 


1 
f. 
_nt 
10 
manufacturer 


2 
..04.1 
50 
_.1 


3 
it... 
100 
inv.ntory_it... 


4 
cua't-oll1er 10 
cuatolller 


5 
order. 
100 
ordera 


I)!SCRIPTION 
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o 
STEP 13: 


Action: 


Effect: 


Reason: 


Access the manf field definitions. 


Enter an f (fields). 


The field entry screen with the manf field 
definitions displays. 


You're ready to lengthen the name field, and then 
add the mcity, mstate, and mzip fields. 


[schant] 


RECORD: IlI4nf 


UNIFY R.I•••• 3.2 


Modify D.t. 
Baa~ Daaiqn 
10 JAIl 1985 - 
14:22 


LII 
CMD 
FIELD 
KEY 
REF 
TYPS 
LSII 
LONG NAME 
COMB. 
FIELD 


_no 
mname 
IlI4dd 


IlmlERIC 4 
STRING 
30 


STRIIiG 
30 


Numbar 
II.... 
MlSr••• 


[1I]axt paq., 
[PJrav paqa, 
[A]dd lin., or number: 
2- 


l 
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o 
STEP 14: 


Action: 


Effect: 


o 
STEP 15: 


Action: 


Access the mname field for modification. 


Enter a 2 as shown. 


The cursor moves to the specified line in the CMD 
column. 


Select modify mode. 


Enter an m in the CMD column. 


[scl1ent] 


RECORD: _nf 


1.IIll:FY Release 
3.2 
Modify Data !lase Design 


Modifying a Data Base Design 


10 JAll 1985 
- 
14: 22 


LN 
OlD 
FIELD 
l<EY 
REF 
TYPE 
LEN 
LONG 
NAME 
COMB. 
FtELD 


1 


2 
3 
• 


aJIoIERIC 
4 
STRING 
35 


STRING 
30 


Jrum.ber 
"'me 
Midr••• 


o 
STEP 16: 
Action: 


o 
STEP 17: 


Action: 


Change the LEN value of the mname field. 
Move the cursor to the LEN column and change 
the value from 30 to 35 as shown. 


Press IRETURNI enough times to move the cursor 
to the REF column. 


Return to the CMD column. 


Press ICTRLI IQ] with the cursor in the REF 
column. 


[scl1ent] 


RECORD: man! 


OlfIFY Rel.....e 3.2 
Modify D.t. Ba.. D••ign 


10 JAll 1985 _ 14:22 


LN 
ClID 
FIBLD 
ICBY 
REF 
TYPB 
LBH 
LONG NAME 
COMB. 
FIELD 


1 
2 
3 


IlllMBRIC 4 
STRIHG 
35 


STRIHG 
30 


Num!l.r 
HAm. 
Add.r••• 


o 
STEP 18: 


Action: 
Effect: 


Display the paging prompt. 


Enter a q, then press IRETURNI. 
The paging prompt displays at the bottom of your 
screen as follows. 
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(schent] 


RECORD: _nf 


UNIFY Relea•• 3.2 


Modify Data Ba.. oe.iqu 


10 
JAJl 
1985 - 
14: 22 


LN 
CKD 
FIELD 
IalY 
REF 
TYPE 
LEN 
LONG 
KAME 
COIIB . 
FIELD 


-mKERIC" 
DUmb.r 
STRING 
35 
""". 


STRING 
30 
addre•• 


(N]ext pa... , 
[P]rev pa... , 
(A]dd lin., or DUmb.r .. 


o 
STEP 19: 


Action: 
Reason: 


Select add mode. 
Enter an a at the paging prompt. 
You're ready to add the new field .definitions. 


(schent] 
UllXFY a.l•••• 3.2 
10 JAJl 1985 - 
14:22 
(A]DD 
Modify Data Ba•• Desiqu 


RECORD: manf 


LN 
CM!) 
FIELD 
KEY 
llEF 
TYPE 
LEN 
LONG IlAMl!: 
COIIB. 
FIELD 


• 


( 


1 
mano 
IlVMERIC 4 
Numb.r 


2 
_. 


STRING 
35 
N.... 


3 
madd 
STRING 
30 
Md.r••• 


4 
mcity 
STRING 
20 
City 
5 
matate 
STRING 
2 
St.t. 


6 
JUip 
STRING 
5 
Zip-Cod. 


{ 
'.. 
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0 
STEP 20: 


Action: 


0 
STEP 21: 


Action: 


Reason: 


Add the new field definitions. 


Enter the thr~e fields, ·mcity, mstate, and mzip as 
shown. 


Retu!n to the record type entry screen. 


Press ICTRU ill] until the record type entry screen 
displays. 


You're ready to modify the item record fields. 


(achant] 
UNIFY Releaae 3.2 
Modify Data Baae Oeaiqn 
10 JAN 1985 - 
14:22 


LN 
CMO 
RECORD 
EXPECTED 
LONG NAME 
DESCRIPTION 


1 
manf 
10 


2 
modal 
50 
3 
f- 
item 
100 


4 
customer 
10 
5 
or~ere 
100 


o 
STEP 22: 


Action: 


o 
STEP 23: 


Action: 


Reason: 


manufa.cturer 
modal 
inventory_item 
customer 
ordera 


Move to the item record type definition. 


PressJRETURNI to position the cursor on line 
three. 


Display the item field entry screen. 


Enter an f as shown. 


You're ready to add the iorder and ipamt fields. 
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[schent] 


RECORD: item 


UNIFY !\alease 3.2 


Modify Data Base Deai'1n 


10 
JAJI 
1985 
_ 
14: 22 


LN 
010 
FIELD 
KEY 
REF 
TYPE 
LEN 
LONG NAME 
COMB. 
FIELD 


1 
ano 
.mERIC , 
·SeriaLNWllller 


2 
!model 
.okey 
COMB 
_eLID 


3 
14d 
DATE 
Acquisition-Data 


4 
iaa1 
.&IIOll1l'l' 
5 
8a.l••_price 
5 
iorder 
onWl\ 
IIIll!ERIC , 
Order_Humber 


6 
ipamt 
.&IIOll1l'l' 
5 
Purchase_Price 


[N]ext pa'1e, 
[P]rev pa'1e, 
[A]dd line. or number - 


o 
STEP 24: 


Action: 
Effect: 
o 
STEP 25: 


Action: 


Add the two new item field definitions. 


Enter the iorder and ipamt fields as shown. 


This completes the data base design changes. 


Return to the record type entry screen. 
Press ICTRL! IQJ until the screen form displays. 


(schent] 
WIFY Releass 3.2 


Modify Data Baae De.iqn 
10 JAJI 1'85 _ 14:22 


LN 
CMD 
RECORD 
EXPECTED 
LONG NAME 


1 
manf 
10 
mAnufacturer 


2 
model 
50 
model 


3 
q- 
item 
100 
inventory_item 
4 
customer 10 
cuatomer 


5 
orders 
100 
ordars 


DESCRIPTION 


l 
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o 
STEP 26: 


Action: 


Display the paging prompt. 


Enter a q as shown. 


o 
STEP 27: 


Action: 


Modifying a Data Base Design 


Return to the Data Base Design Utilities menu. 
Press ICTRU ill] until the menu displays. 


4.2 PRINTING A DATA BASE DESIGN REPORT 


Once you modify the data base design, you're ready to check the 
results of your changes against the report at the beginning of this 
section. 


In this subsection, you produce a data base design report. 


r[dbdeaign] 


SELECTION: 
2- 


UNIFY Rel.a.e 3.2 


Data Ba•• De.iqn 
Utili~i•• 


2. 
Print Data Ba•• O••iqn 


3. 
Create Data Baae 


4. Write Data Ba•• Backup 


5. Reconfiqur. Data Ba•• 


6. 
Add, Drop B-Tre. Indexe. 


7. Advanced Field Attribute. 


10 JAN 1985 _ 14:22 


o 
STEP 28: 
Select the "Print Data Base Design" (schIst) 
option. 
Action: 
Enter a 2 as shown. 


Effect: 
You produce a report so you can verify the result 
of your changes with the report at the beginning 
of this section. Check your printer. 
You will be adding data values for the manf and item fields in 
Section 5.3. You also will be inserting data in the orders and 
customer record types using SQL in Section 10.10. 
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4.3 RECONFlGURING THE DATA BASE 


The changes you just made to the data base design are not yet 
reflected in the data base itself. For the data base to reflect the 
modifications, you must reconfigure the data base. 


To protect your data base in case of a hardware or software failure 
during reconfiguration, you must make a copy of the data base 
before starting. This copy is called a backup. 


Experienced system administrators recommend backing up the data 
base before and after any major operation. Then, should something 
go wrong, you can restore the data base from the backup. 


In this subsection, you will write a backup, then reconfigure the data 
base. 


l. 


[dbdesiqn] 
UNIFY Re1eaee 3.2 
Data Baa. D.sign Utiliti•• 


1. Modify Data Baae Deeiqn 


3. 
Create Data Ba•• 


4. Write Data Baae Backup 


5. Reconfiqure Data Ba•• 


6. Add, Drop B-Tr•• Indexes 


7. Advanced Fie1d Attribute. 


10 JAN 1985 _ 14:22 


SE::"ECTION: 
4- 
f8jjIilk••*~B__~I~~t.l•••1iIl.lfMj--- 
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o 
STEP 29: 


Action: 


Effect: 


Select the "Write Data Base Backup" (budb) 
option. 


Enter a 4 as shown. 


The screen form displays as follows. 


[bUdbl 
UIlIFY 
b~ 
a. 3.2 
Writ. Data 
B 
Backup 


Modifying a Data Base Design 


10 JAN 
1985 
_ 
14:22 


This pcoqram copies the data. baa. and dAta. 4ic:tionary 
to diskettes or up.. 
110 one .18. should. be lUIinq the 
data bas. 
Yhi~. thia 
~oqram ia runninq. 


PROCEED? y" 


o 
STEP 30: 


Action: 


Note: 


Effect: 


o 
STEP 31: 


Action: 


Note: 


Proceed with the backup. 


Enter a y at the PROCEED? 
prompt. 


An n or ICTRU ill! in response to PROCEED? 
stops the process and returns you to the menu. 


The following message displays. 


Mount first diskette/tape -- 


Respond to the message. 


Make sure you write-enable and properly install 
your backup medium (diskette or tape) in the 
backup device before you respond to the 
PROCEED? 
prompt. 


Press IRETURNI and the system writes the 
backup. 


Before you use diskettes, you must format them. 
For information on formatting diskettes, see your 
hardware manual. 
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Effect: 


o 
STEP 32: 


Action: 


Effect: 


When the backup completes, the following prompt 
displays. 


Back up complete. 


Respond to the prompt. 


Press IRETURNl. 


The menu redisplays. 


(c1bcleeiqnJ 
UNIFY Re18ase 3.2 


Data Base Oesign Utilities 


1. Modify Data Base Design 


2. Print Data BAse Design 


3. Create Data B488 


5. Reconfigure Data Bas8 


6. 
Ad4. 
Drop a_Tr•• Indexe. 


7. 
A4v&nced Field Attribut•• 


10 JAH 
1985 
_ 
14: 22 


SELECTION: 5- 
~._:•• 
.ii.jl.i~_.~iiiliiliij---- 
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o 
STEP 33: 


Action: 


Effect: 


Select the "Reconfigure Data Base" option. 


Enter a 5 as shown. 


The screen form displays as follows. 


[scom] 
UHIFY \lab.... 
3.2 


aeconfiqure Data sa•• 


Modifying a Data Base Design 


10 JAIl 
1985 
- 
14: 22 


This p£oqram reformats the datA hAa. to reilect any 
chanqa. in atructure you bave 
~d. uainq .edify Data 


Baa. Design. 
You ahould .ake • 
backup copy of the 
data base on 41skette. or tape with write Data Baa. 
B..ckup (budb) before .....inq this pcoqr..m. 
In addition. 
no one else ahould be uainq the data. 'baa. vhile this 
program is running. 


PROCEED? y. 


o 
STEP 34: 


Action: 
Note: 


Effect: 


Proceed with the reconfiguration. 


Enter a y as shown. 
An N or ICTRU illJ in response to PROCEED? 
stops the process and returns you to the menu. 


The following messages display. 
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[8eom] 


Phase 
I 


Rla.SIiI 
II 


UlIIFY Roha.. 
3. 2 
Reconfiqure 
Data. Baae 


10 
JAJf 1985 - 
14: 22 


Nominal hash table loadinq factor: 
50~ 
Now load foetor without robuilding: 
S4~ 


REBUILD BASH INDEX? y. 


c 
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o 
STEP 35: 


Action: 


Reason: 


Effect: 


Specify the rebuilding of the hash index. 


Enter a y (yes) as shown to rebuild the hash 
index. 


At this point, the data base design compiles and 
the actual reconfiguration begins. 


Since you increased the total expected number of 
records in the data base, you should increase the 
size of the hash index. 


The following prompt displays. 


[acom] 


Phase I 


FhAs. 
II. 


Phaae III 
.!' 


UNIFY Relaaae 3.2 


aeconfigure 
Data. 
Baae 


Modifying a Data Base Design 


10 JAN 
1985 
_ 
14: 22 


Hominal baeh tAble loading factor: 
50" 


Hew load factor without rebuilding, 
84" 


Use diskette/tape .. the temporary file? u- 


0 
STEP 36: 
Specify the file medium for the temporary file. 


Action: 
Enter an N as shown. 


Reason: 
This prompt allows you to copy the reconfigura- 
tion on diskette or tape. 


When the data base file is too large to copy to 
disk, you must respond to this prompt with a y. 


In this application, you can reconfigure the small 
data base file entirely on the disk. 


Effect: 
The following prompt displays. 


Process complete. Backup the data base. -- 


0 
STEP 37: 
Respond to the prompt. 


Action: 
Press IRETURNI. 


Effect: 
The Data Base Design Utilities menu displays. 


0 
STEP 38: 
Backup the data base file again. 


Action: 
Repeat Steps 29 through'32. 
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Note: 


Effect: 


o 
STEP 39: 


Action: 


4-22 


Copy the data base file to a different tape or 
diskette from the one before. 


You have a copy of the newly reconfigured data 
base, and data dictionary. 


You're now ready to modify the data entry screen 
forms to reflect the new design. 


Return to the UNIFY Main Menu. 


Press the home command key. 


(- 


( 


Section 5 
Modifying Data Entry Screen Forms 


5. Modifying Data Entry Screen Forms 
5.1 Using Paint Screen Forms 
5-2 
5.1.1 Using PAINT Editing Commands 
5-6 
5.1.2 Modifying Data Entry Screens with PAINT 
5-9 


5.2 Printing a Screen Form Report 
5-20 
5.3 Updating Data Base Records 
5-21 


5. MODIFYING DATA ENTRY SCREEN FORMS 


The changes you made to the data base design in Section 4 can now 
be reflected in the design of the current screen forms. This section 
explains how you: 


• 
modify screen forms using Paint Screen Forms 


• 
print a screen form report 
• 
update existing data base records by adding values for the new 
fields 


[mainmenu] 
UNIFY Release 3.2 


UNIFY Main Menu 


10 JAN 1985 _ 14:22 


SELECTION: 2. 


1. 
O••iqu and Cr.ate 
&. Nev Data Baa. 


2. Create or Modify Scre.n Forma 


3. 
SQL - Query/DML Lanquaqe 


4. Edit SQL or RPT Command Files 


5. Add. Modify or Delete Menus 


7. Syetem Administration 


8. 
Data Entry Scr••ne 


( 


( 


o 
STEP 
1:· 
Select the "Create or Modify Screen Forms" 
(screens) option from the Menu Handler. 


Action: 
Enter a 2 at the selection prompt as shown. 


Effect: 
The "Create or Modify Screen Forms" menu 
displays. 


UNifY Tutorial 


Reason: 
This menu lists all the UNIFY options you can 
select to manage screen forms for a data base. 


[screens] 
UNIFY a.l•••• 3.2 


Cr••t. or Modify Scr••n Forms 


2. R.qist.r Scr••n Form with ENTEa 


3. Reqiater Scr••n Form with SQL 


4. Check Scr••n Porm Coordinatea 


5. Display List of Scr••ns 


6. 
1'••'t. Sor••na 


7. Compile Scr••ne 


8. aa.tore Scr••n'to pata Dictionary 


9. Create Default Scre.n Form 


10 JAl{ 1985 - 
14:22 


SELECTION: paint- 


r-;;'~1_~_l_ljil~:$j~~••!.H:i&ii~.j1iE~~[~~i""j7;.ii; 


5.1 USING PAINT SCREEN FORMS 


The term for the Paint Screen Forms option is PAINT. With 
PAINT, you can: 
• 
create, modify, delete, and view screen forms with a full-screen 
editor 
• 
store and access screen forms in the UNIFY data dictionary 


After accessing a screen form, you can move the cursor on the screen 
to add, modify, and delete prompts and screen fields. 
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o 
STEP 
2: 


Action: 


Select the "Paint Screen Forms" option. 


Enter paint at the selection prompt as shown. 


Effect: 


Modifying Data Entry Screen Forms 


The screen form with the operation prompt 
displays as follows. 


(paint] 
UKlFY a.l•••• 3.2 


Pain~ Scr.en Forma 


10 JAN 1985 _ 14:22 


( 


(I]NQUIRE. 
(A]DD. 
(M]ODIFY. 
[D]ELETE • 


The operation prompt: 


[I]NQUIRE, [A]DD, [M]ODIFY, [D]ELETE 


allows you to select an operation mode for PAINT. 


WHEN you want to... 
THEN select... 
see the format of an existing 
i (inquire) 
screen form, but not modify it 
create new screen forms 
a (add) 
add, modify, and delete prompts 
m (modify) 
and screen fields for existing 
screen forms 
delete an existing screen form 
d (delete) 
from the data dictionary. (This 
also removes all references to 
the screen form on menus, and 
in ENTER and SQL screens.) 
return to the active menu 
CI'RLU 
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The mode you select appears in the top left corner of the screen. 
The SCREEN: prompt then replaces the operation prompt. At the 
SCREEN: prompt, you enter the name of the screen form you want 
to access. 
A ICTRLJ ill] erases the current mode and redisplays the operation 
prompt. 


WHEN you are in... 
THEN... 
inquire mode 
the named screen form displays. A 
IRETURNI erases the screen form and 
redisplays the SCREEN: prompt. 
delete mode 
you confirm the request by responding to 
the message Delete? 
Entering a y deletes 
the screen form. Entering an n or pressing 
ICTRLJ ill] cancels the delete request. 
add mode 
a blank screen displays 
modify mode 
the named screen form displa:ys 


The following is an example of a PAINT screen form. 


[paine] 
Command. mocl. 
OHIFY 
R.~.a•• 3.2 


P.in~ Scr••n Porma 


10 JAB 1985 _ 14:22 
F:euae01 
L: 
6 C: 
16 
0) 
® 


CUSTOMER NAME: SSSSSSSSSSSSSSSSSSSSSSSSSSSSSS C!) 
ADDRESS 
: SSSSSSSSSSSSSSSSSSSS 


CITY 
: SSSSSSSSSSSSSSSSSSSS 


STATE 
: SS 


The PAINT screen form has the following components. 
CD 
Screen field. The screen fields show both their length and 
data base field type. The symbol that represents each data base 
field type is as follows. 
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TYPE 
SYMBOL 
STRING 
S 
NUMERIC 
N 
AMOUNT 
A.AA 
DATE 
MM/YYjDD 
FLOAT 
F.FF 
TIME 
HH:MM 


(3) 
Cursor coordinate. The cursor's current position is indicated 
in the top right corner by L: (line) and C: (column). 


® 
Screen field prompt. The name of the current screen field (if 
any) is displayed to the right of the F: (field) prompt. If the 
cursor is positioned over a screen field, then that screen field is 
said to be current. 
The components, then, of this PAINT screen form indicate that the 
current screen field name is custOl; its type is STRING; and its 
length is 30. 
When you complete an editing session, you end add or modify mode 
by pressing quit (the q command key). The edit prompt then 
displays. This prompt: 


[S]av~ [D]ontt sav~ [R]esume editing 


allows you to either save or not save your changes, or resume editing. 


WHEN you want to... 
THEN .enter... 
save the changes you made 
s (save). 
The screen form is processed 
and saved in the data 
dictionary. 
ignore the changes you made 
d (don't save). 
The screen form remains the 
same. 
continue editing the screen form 
r (resume editing) or CTRL U 
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5.1.1 USING PAINT EDITING COMMANDS 


There are four types of PAINT screen editing commands: cursor 
motion, prompt editing, screen field editing, and miscellaneous. 


You can change the command keys for PAINT by modifying an AS- 
CII control file. 
For information on the structure and use of this 
control file (named unicap), see the UNIFY Reference Manual, Sec- 
tion 1.1.6. 


Conclude your editing session by saving the changes. This involves 
an extensive data base update. So wait until you're through making 
all changes before you save the screen form. 


A summary of the PAINT commands and their default command 
keys follows. 
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Cursor l\fotion Commands 


The cursor motion commands allow you to position the cursor where 
you want to edit. 


WHEN you want to move the cursor... 
THEN use... 
left 
- 
(left-arrow), 
h, or CTRL H 
right 
- 
(right-arrow), 
space, or 1 
up 
1 (up_arrow) 
or k 
down 
! (dowILarrow), 
j, or CTRL J 
to the next line 
RETURN 
to the next word 
w 
to the previous word 
b 
to the home position 
H 
(line 2, column 0) 
to the bottom of the screen 
L 
(line 22,column 0) 
to coordinates xy 
gxy 
to column 0 
0 
on the current line 
to the first non-blank character on the 


A 


current line 
to the last non-blank character on the 
$ 
current line 


5-7 


UNIFY Tutorial 


Prompt Editing Commands 
The prompt editing commands let you enter and modify the text 
displayed on a screen form. 


WHEN you want to... 
THEN use... 
start append mode 
a 
start insert mode 
1 
start replace mode 
R 
end append, insert, 
ESC 
or replace mode 
transfer a line 
t 
delete a character 
x 
open a line above 
0 
the current line 
open a line below 
0 
the current line 
delete the current line 
d 
set normal video 
n 
set reverse video 
[ 
set underline video 
] 
set reverse and underline 
+ 
video 


Screen Field Editing Commands 


The screen field editing commands let you enter and modify screen 
fields. 


WHEN you want to... 
THEN use... 
add a field 
A 
modify a field 
M 
delete a field 
D 
transfer a field 
T 
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Miscellaneous Commands 


WHEN you want to... 
THEN use... 
display help 
? 
toggle the cursor position display 
c 
(ON/OFF) 
display the screen form name 
s 
quit PAINT mode 
q 
redraw the screen 
CTRLR 
exit to the active menu 
CTRLX 
(no saves) 


5.1.2 MODIFYING DATA ENTRY SCREENS WITH 
PAINT 


Now that you're familiar with the PAINT editing commands, you're 
ready to modify your data entry screens. 


[paint] 
UNIFY a.l•••• 3.2 
Paint Scr••n Forma 
10 JAN 1985 _ 14:22 


l 


[I]NQUIRE. 
[A]DD. 
[M]ODIFY. 
[D]ELETE m- 
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o 
STEP 
3: 


Action: 
Effect: 


Select modify mode. 
Enter an m at the operation prompt. 


The mode displays in the top left corner; the 
SCREEN: prompt replaces the operation prompt. 


[paint] 
(!o!]OOIFY 


SC-aEEN: mant 


UNIFY ReIe....e 3.2 
Paint Scr••n Forma 
10 JAN 1985 _ 14:22 


o 
STEP 
4: 


Action: 


Effect: 


5-10 


Access the data entry screen form for manufac- 
turer records. 
Enter the name of the screen form, manf, at the 
prompt. 
The prompt clears and the cursor moves to the 
first blank line (line two) where you start editing. 


Modifying Data Entry Screen Forms 


(paint) 


COllllll4nd mode 
• 


lIIlIFY !lAh... 3.2 


Paint. SCr••n 
Forma 


10 
JItJl 
1985 
_ 
14: 22 
P: 
L: 
2 C: 
0 


\ . 


Manu!act.urer ID: 
HHUH 
Hame 
SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS 


Address 
SSSSSSSSSSSSSSSSSSSSSSSSSSSSSS 


PAINT has two modes: command mode and input mode. 


When you're in command mode, you: 


• 
can move the cursor on the screen 


• 
can begin other commands (prompt editing, screen field editing, 
miscellaneous commands) 


• 
cannot enter characters on the screen 
When you're in input mode, you can enter characters on the screen 
as text. 


To exit input mode, press ~. If you enter an invalid command, 
you will hear a "beep." 


When you need help on the two modes, or require assistance for the 
cursor motion and edit coqunands, enter a !. 
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The following is a guide on what to enter with PAINT. 


: -2.. 
: --J.- 


(paint] 
CommAnd mode 
• 


Manufacturer ID: 
Name 
Address 
City 
State 
Zip Code 


UNIFY Release 3.2 
Paint Scr••n Forma 


lMnI' 
SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS 
SSSSSSSSSSSSSSSSSSSSSSSSSSSSS 


I 


10 JAN 1985 _ 14:22 


F: 
L: 
2 C: 
1 


0 
STEP 
5: 


Action: 


0 
STEP 
6: 
Action: 


Effect: 


This is the complete screen design for manufacturers. Notice the line 
and column position indicators at the top right corner of the screen. 
The indicators help you position the cursor. Y(\u know, then, where 
you are on the screen without counting the lines and columns. 
You will be adding three prompts: 


. City: 
State: 
and 
Zip Code: 


with corresponding screen fields. 


Notice the screen fields for the prompts have numbers in the guide. 
The field numbers reference the information you enter on the PAINT 
Screen Form. You're now ready to add the first screen prompt and 
screen field. 


Move the cursor to the first blank line after the 
ADDRESS prompt. 
Press IRETURNI until the cursor is in position. 


Select append mode. 
Press a. 


Input mode replaces Command mode in the top left 
corner. 
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[paint] 
Input. mode 
UNIFY Release 3.2 
paint Screen Forma 


10 JAM 1985 _ 1.:22 
P: 
L: 
7 C: 
18 


IMIU 
55555555555555555555555555555555555 
555555555555555555555555555555 


:. 


Manufacturer 1D: 
Kame 
Addresa 
City 


0 
STEP 
7: 


Action: 


Note: 


0 
STEP 
8: 


Action: 


0 
STEP 
9: 


Action: 


Effect: 


Add the first screen prompt. 


Enter the prompt, City:, as shown. 


Remember to enter the colon, then a blank space. 


End append mode. 


Press~. 


Add the screen field for the prompt. 


Press A, that is ISHIFTI and "a." 


The following prompts display at the bottom of the 
screen. 


SCREEN PIELD:CI) 
TYPE: 


DATA BASI!: FIELD:® 


LENGTH: 


These prompts let you define screen fields. 
CD 
ScREEN FIELD. This is an eight character name for the 
screen field. You can use the same screen field name on 
different screen forms. However, the screen field name must be 
different from the data base field name. 


l 
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® 
DATA BASE FIELD. This is the name of the data base field 
that corresponds to the screen field. The data base field name 
is optional. 


WHEN you... 
THEN... 
enter the data base field name 
PAINT automatically enters the 
type and length information 
from the data dictionary if the 
data base field name is valid. In 
this case, you cannot modify the 
type and length. 
leave the data base field name 
you must enter the field type 
blank 
(NUMERIC, STRING, DATE, 
TIME, AMOUNT, or FLOAT) 
and the field length 


WHEN you press ICTRU IQ] at the DATA BASE FIELD: 
prompt: 
• 
you are back in command mode 
• 
the screen field is displayed on the screen 


SCREEN FIELD: 
.mci~y 
TYPB: STRING LENGTH: 
%0 
DATA BASE FIELD: 
mci~y 


o 
STEP 10: 
Define the screen field. 


Action: 
Enter the data as shown. 


Effect: 
When you enter the data base field name, PAINT 
automatically enters the type and length 
information from the data dictionary. 
o 
STEP 11: 
End screen field add mode. 


Action: 
Press ICTRU IQ]. 


Effect: 
The screen looks as follows. 
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(paint) 


Command. node 


Manufacturer 


Name 
Address 
City 


UIlIFY ReleA.. 3.2 


Paint Scr.en Forma 


!D: 
liIIlIll 


SSSSS~SSSSSSSSSSSSSSSSSSSSSSSSSSSSS 
SSSSSSSSSSSSSSSSSSSSSSSSSSSSSS 


: 
~SSSSSSSSSSSSSSSSSSS 


10 
JIlJ{ 
1985 
_ 
14: 22 
P: _city 
L: 
7 C: 
18 


o 
STEP 12: 


Action: 


Complete the screen design. 


Enter the last two prompts and screen fields. 
By 
field number, the screen field information you 
enter is as follows: 


Ea:c.: 
.En.w:: 


Field 
Screen 
Data Base 
Number 
Field 
Field 
Type 
Length 
2 
smstate 
mstate 
STRING 
2 
3 
smzip 
mzip 
STRING 
5 


Effect: 
The following shows what your new screen looks 
like. 


( 


(paint) 
C01Mland mod. 
UNIFY ReleA.e 3.2 


Pain~ Scr••n Forma 
10 
JIlJ{ 1985 _ 14:22 


F: .mzip 
L: 
9 C: 
18 


Manufacturer ID: 
Name 
Addr••• 
City 
sta.te 
Zip Code 


IMflf 
SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS 
SSSSSSSSSSSSSSSSSSSSSSSSSSSSSS 
SSSSSSSSSSSSSSSSSSSS 
SS 
ssns 


l. 


l 


o 
STEP 13: 


Action: 


Effect: 


End the edit session. 


Press q to quit. 


The following prompt displays. 
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[paintl 


Manufacturer 10: 


Address 
City 
Sta.te 
Zip Coda 


1JIl1:PY bl.... 3.2 
Paint. SCre.n Form. 


Illllnl 
SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS 
SSSSSSSSSSSSSSSSSSSSSSSSSSSSSS 
SSSSSSSSSSSSSSSSSSSS 
SS 
&SSSS 


P: 
10 
JAlf 
1985 
_ 
14: 22 


[Slav., 
[Dlon't aav•• 
[Rleeum. editing .. 
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o 
STEP 14: 


Action: 


Effect: 


Save the changes and process the screen form. 
Enter an s at the prompt as shown. 


PAINT saves the changes you made in the data 
dictionary, and then processes the screen. It is 
now ready to use. 


o 
STEP 15: 


Action: 


Modifying Data Entry Screen Forms 


Modify the model data entry screen. 


Add a new screen field - 
repeating Steps 9 
through 11 - 
with the screen guide and 
corresponding screen field information as shown: 


[paint] 


COmmAnd moda 
• 


UNIFY aele.se 
3.~ 
Paint Screen Forma 
10 JAJi 1985 
_ 
14:~~ 


F: 
L: 
~ c: 
0 


Mcx1el Number 
: 
IIUUlfllU1f 
Manufacturer ID: 
UHUU 


Description 
: SSSSSSSSSSSSSSSSSSSSSSSSSSSSSS 


Em::. 
Field 
Number 
1 


.En1.eI::. 
Screen 
Field 
smname 


Data Base 
Field 
mname 
Type 
STRING 
Length 
30 


Note: 


o 
STEP 16: 


Action: 


The field name is in the manf record type, while 
this screen form's target record type is model. 


The explicit relationship in the data base design 
between these two record types allows you to put 
this field on the form. 


When you enter a manufacturer ID, ENTER will 
display the corresponding name. 


Save the changes. 
Repeat Steps 13 and 14. 
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o 
STEP 17: 


Action: 
Modify the item data entry screen. 


Use the appropriate PAINT commands to redesign 
the screen form as follows: 


[p<lint l 
Comm.a.nd m.ode 
• 


UNIFY Release 3.2 


P4in~ Scr••n Forma 
10 JAN 1985 _ 14:22 


F: 
L: 
2 C: 
0 


Serial Nwnber 
: ~ 
*anu!acturer ID : SUUB 
*odel Humber 
: ~ 


Acquisition Date: MH/DD/YY - 
Sala8 Price 
: AAAAA.AA 


Order Number 


Purchase Price 
:--L--- 


Ear:. 
En1eI:: 


Field 
Screen 
Data Base 
Number 
Field 
Field 
Type 
Length 
1 
smname 
mname 
STRING 
35 
2 
sdesc 
mdes 
STRING 
30 
3 
siorder 
iorder 
NUMERIC 
9 
4 
sipamt 
ipamt 
AMOUNT 
5 


Note: 


0 
STEP 18: 
Action: 


0 
STEP 19: 
Action: 
Effect: 


Add the blank lines using the open command key. 


Save the changes. 


Repeat Steps 13 and 14. 


Exit PAINT. 
Press ICTRLI TIll while at the operation prompt. 
The menu redisplays. 
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Guidelines on Creating Screen Forms and Using ENTER 
When you design screen forms for ENTER, it's important to know 
some basic rules. The rules govern how ENTER controls screens 
when they are running. If you keep the following points in mind, 
you will produce screens that operate more efficiently. 


1. Primary and Secondary Record Types 


An ENTER screen can update a single primary record type; and can 
display fields from secondary record types. For secondary fields to 
display, there must be an explicit relationship between the primary 
and secondary record types. 


For example, the manufacturer name displays on the model screen 
form because there is an explicit relationship between the primary 
record type, model, and the secondary record type, manf. 


2. Combination Fields 


When you use information from a COMB field, group the 
components together on the screen form. This is because ENTER 
processes the parts of the COMB field in sequence. Otherwise, 
scattered parts of a combination field will cause the cursor to move 
irregularly. 


3. Information Display (Lines 21-23) 
The last three lines on the screen form are for ENTER to display 
information, prompts, and error messages. If you enter screen 
prompts or fields in line 21, 22, or 23, the system will overwrite your 
information. 
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5.2 PRINTING A SCREEN FORM REPORT 


When you require. documentation for the system or a form of off-line 
backup, the "Print Screens" option allows you to print a report. 


o 
STEP 20: 


Action: 


Effect: 


Print a report of the data entry screen forms. 


Enter sfrep, "Print Screens," at the selection 
prompt. 


The screen form displays as follows. 


(sfrop] 


SCREEN .CD 


LISTING (Y or N]:0 
PRINT SCREEN:(!) 


UNIFY a.l•••• 3.2 
Print. Scr••n. 


10 JAN 1985 _ 1.:22 


The "Print Screens" option allows you to print a screen form as a 
report with or without the attributes of each screen field. 


The Print Screens form has the following prompts. 
CD 
SCREEN. This is the name of an existing screen form. Enter 
either the name of a screen form, or enter all to print all screen 
forms in the data dictionary. 


® 
LISTING [Y or N]. A y (yes) answer prints a tabular report 
that lists the attributes of each screen field. An n (no) answer 
does not print this part of the report. 


® 
PRINT SCREEN. A y (yes) answer prints an image of each 
screen as it displays on a CRT. An N (no) answer does not 
print the image. 


The following screen example shows what you enter. 
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[sfrap) 


SCREEN 
.11 


LISTING 
[Y or 
N): y 


PRINT 
SCREEN: 
y 


1JIlIFY R.le.... 3.2 
Print SCreens 


10 
JAN 
1985 
_ 
14: 22 


o 
STEP 21: 


Action: 


Effect: 


Print all the data entry screen forms. 


Respond to the prompts as shown. 


When the screen form report completes, the active 
menu redisplays. 


5.3 UPDATING DATA BASE RECORDS 


Now that you have updated and processed all the screen forms in 
Sections 5.1 and 5.2, you're ready to modify existing manf and item 
records. 


0 
STEP 22: 
Return to the UNIFY Main Menu. 
Action: 
Press the home command key. 


0 
STEP 23: 
Select the Data Entry Screens menu. 


( 
Action: 
Enter an 8. 


Effect: 
The menu displays. 


I 
\.. 
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[u.sermenu] 
UNIFY Releaee 3.2 
Da.ta Entry Scr••ns 


2. 
Model Maintenance 


3. 
tnvant:.ory It.am Maintenance 


10 JAN 1985 
_ 14:22 


SELECTION: a 
___11MllL.:'J:~~.f:~;:~:~&~IIJ_%__:!81~m~BI 
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o 
STEP 24: 


Action: 
Effect: 


Select the "Manufacturer Maintenance" option. 
Press the select command key. 
The new "Manufacturer Maintenance" screen 
form displays. 


Modifying Data Entry Screen Forms 


[manf] 


M~nufa.ct.urer m: 
Name 
Address 
City 
State 
Zip Code 


UNI:FY Release 3.2 


Manut&c~ur.r MAintenance 


10 
JIoJi 
1985 
- 
14: 22 


[I]NQUIRE. 
[A]DD. 
[M]ODIFY. 
[D]ELETE" 


o 
STEP 25: 
Select modify mode. 


Action: 
Enter an m at the operation prompt as shown. 


Effect: 
The cursor moves to the Manufacturer ID screen 
field prompt; the following prompt replaces the 
operation prompt. 


Begin search [CTRL E], Clear field [CTRL Z], Exit [CTRL X] 


Note: 
When this prompt displays, you can search the 
data base using any of the fields on the form. 


[manf] 
[M]ODIFY 


Manufacturer ID: 
100_ 


Name 
Address 
City 
State 
Zip Code 


UNIFY aelea•• 3.2 
Manufacturer Maintenance 


10 JIoJi 1985 _ 14:22 
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D 
STEP'26: 
Select the first record to update. 


Action: 
Enter the manufacturer ID number, 100, at the 
first screen field prompt. 


Note: 
This field is the primary key of the manf record 
type. 


D 
STEP 27: 
Display the selected record. 


Action: 
Press !RETURN!. 


Effect: 
ENTER selects manufacturer number 100 and 
displays the record. 


D 
STEP 28: 
Add City, State, and Zip Code values. 


Action: 
Enter Centerville, CA, and 95923, respectively. 


Effect: 
With the cursor back at the first prompt, the 
screen form displays as follows. 


[manf] 
PljODIFY 


UNIFY aelea•• 3.2 


Manufacturer Maintenance 


10 JAN 1985 - 
14:22 


Name 
Address 
City 
State 
Zip Code 


~anufacturer ID: 
100 
RH Smith Manufacturinq 
523 Galveston st. 
Centerville 
CA 
: 95923 
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D 
STEP 29: 


Action: 
Effect: 


Clear the screen form. 


Press ICTRU IQ]. 
The screen form clears and is ready to accept new 
selection specifications. 


( 


o 
STEP 30: 


Action: 


Modifying Data Entry Screen Forms 


Upda,te the remaining records. 


Enter the following data: 


c, 


Em:: 
.EnieI:: 


MANUFACfURER 
aTY 
STATE 
ZIP CODE 
ID 
101 
San Francisco 
CA 
94109 
102 
Eagan 
MN 
55422 
103 
Rancho Cordova 
CA 
95670 
104 
Tucson 
AZ 
85745 
105 
New York 
NY 
10022 


0 
STEP 31: 
Return to the active menu. 


Action: 
Press ICTRLI IX]. 


0 
STEP 32: 
Update the records using the new "Inventory Item 
Maintenance" screen form. 


Action: 
Enter item at the operation prompt. 


0 
STEP 33: 
Select modify mode. 


Action: 
Enter an m at the operation prompt. 
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0 
STEP 34: 
Add a purchase price to each item record. 
Action: 
Select each item record"by its key field, Serial 
Number, and add the Purchase Price using the 
following table: 


Ea.t: 
.En1eI:: 


Serial 
Purchase 
Number 
Price 
1001 
7.25 
1002 
7.35 
1003 
7.25 
1004 
8.90 
1005 
9.25 
1006 
6.00 
1007 
5.25 
1008 
2.20 
1009 
2.00 
1010 
3.00 
1011 
2.20 
1012 
5.75 
1013 
9.23 
1014 
13.23 


Note: 
You cannot enter an Order Number at this point 
because there are no orders in the data base to 
reference. You will enter orders in the next 
section. 


0 
STEP 35: 
Return to the Menu Handler. 
Action: 
Press ICTRL! IX]. 


Reason: 
You're now ready to use SQL. 
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Section 6 
Using the SQL QueryjDML Language 


6. Using the SQL Query/DML Language 
6.1 Using the Help Features 
6-3 
help - records - fields 
6.2 Selecting Records 
6-7 
select - from· where· or 
edit· restart - start - and 
between - unique 
6.3 Using Arithmetic Expressions 
6-13 
6.4 Ordering Output 
6-15 
order by -. desc • asc 
6.5 Using Aggregate Functions 
6-16 
max - min - sum· avg 
countC*) 
6.6 Grouping Records 
6-18 
group by 
6.7 Using Nested Queries 
6-19 
select· where 
6.8 Using the Having Clause 
6-22 
having - group by 
order by - where 
6.9 Using Multiple File Queries 
6-24 
from· where 
6.10 Sending Data to an ASCII File 
6-26 
into - lines 
6.11 Using the Insert Clause 
6-28 
insert into 
6.12 Using the Update Clause 
6-31 
update - set - < > 
6.13 Using the Delete Clause 
6-33 
delete - end 
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6. USING THE SQL QUERYjDML LANGUAGE 


The previous sections showed you how·to develop and enhance an 
inventory system: 


• 
from creating the data base, to adding test data 
• 
from reconfiguring the data base, to modifying data entry scree~ 
forms 
You performed all these steps by simply choosing menu options and 
filling in forms. 
Now suppose you want to select, update, or delete entire groups of 
records, or send data to an operating system file. And suppose you 
want to perform calculations and an analysis. 


You can perform these activities simply, directly, and quickly using 
English words as commands. UNIFY provides you with a query 
language for these operations. 
This section acquaints you with most features of the major UNIFY 
query language - 
Structured Query Language (SQL) - 
whose 
design originates from IBM. 
SQL is an English keyword based query language that is powerful 
and flexible. The result of IBM's extensive tests is a language easy 
enough for non-programmers to learn, yet powerful enough for data 
processing professionals to use. 


The inventory data base currently does not have the depth to show 
all of SQL's uses. But you get a sample of SQL's capabilities with 
the exercises in this section. For additional SQL features, see the 
UNIFY Reference Manual, Section 6. 


An SQL query consists of clauses, each of which begins with a 
keyword. Because keywords have special meaning, you cannot use 
them as data base record type or field names. The programs for 
entering and modifying the data base design prevent you from doing 
this. 


The following is a list of SQL keywords. 


and 
desc 
help 
min 
separator 
where 
ase 
edit 
10 
not 
set 
write 
avg 
end 
insert 
or 
start 
between 
fields 
into 
order 
sum 
by 
from 
IS 
records 
unique 
count 
group 
lines 
restart 
unlock 
delete 
having 
max 
select 
update 


UNIFY Tutorial 


There are required and optional SQL clauses. The required clauses 
are as follows. 


select information from the data base 
from specific record types 


The optional clauses are as follows. 


where a condition is true or false 
group by specific fields 
having a true or false condition 
order by specific fields 
into an ASCII file 


A part of the SQL language lets you update the data base. This part 
is called the Data Manipulation Language (DML). The Query and 
DML languages work together. The three DML clauses are as 
follows. 


insert 
records into the data base 
update fields in existing records 
delete 
records from the data base 


For more information on DML, see Sections 6.10, 6.11, and 6.12. 
This section consists of steps, exercises, and examples. To keep the 
data base of your application current, you must complete the steps in 
Sections 6.10, 6.11, and 6.12. The basis of the exercises is the 
expanded data base design you developed in the previous sections. 
As a reminder, you are at the UNIFY Main Menu. 
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/[1ll4inmenu] 
OHIFY aelea.e 3.2 
U1fIFY Main Menu 
" 


10 JAN 1985 _ 14:22 


2. Create or Modify Screen Forma 


3. 
SQL - QuerylDML Lanquaqe 


4. E4it SQL or RPT Comman4 Fil.e 


5. A44. Modify or Delete Menua 


6. Data Ba.e Oe.iqn Utilitie. 


7. Sy.te. Admini.tration 


8. Data Entry Screena 


<" 


o 
STEP 
1: 


Action: 
Effect: 


Select the "SQL - 
QueryjDML Language" op- 
tion. 
Enter a 3 as shown. 
The menu clears and the SQL prompt (sql» 
displays. 


6.1 USING THE HELP FEATURES 


UNIFY provides three types of help that make learning and using 
SQL easier. You can ask for a: 


• 
description of the general SQL syntax 
• 
brief explanation of each SQL keyword or keyword phrase 


• 
list of valid data base record type and field names 


t. 


o 
STEP 
2: 


Action: 


Select the first type of help. 


Enter help at the SQL prompt. 
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Effect: 


sql> help 


The help information displays as follows. 


-- Structured Query Language (SQL) 


SQL is a query language baeed on an English keyword syntax. 
A query is composed of a series of keyword clauses. 
The keywords that introduce each clause are as followe: 


select 
insert 
from 
update 
where 
delete 


group by 
having 
order by 
into 


I 'help <keyword>". 
Help about any keyword can be obtained by typing 
The complete list of SQL keywords is as follows: 
and 
desc 
help 
min 
asc 
edit 
in 
not 
avg 
end 
insert 
or 
between 
fields 
into 
order 


by 
from 
is 
records 
count 
group 
lines 
restart 


delete 
having 
max 
select 


separator 
set 
start 
sum 
unique 
unlock 
update 


where 
write 
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o 
STEP 
3: 


Action: 
Reason: 


Effect: 


Select the second type of help. 


Enter help and the select keyword. 


You're asking for information on a specific 
keyword. In this case, the keyword is select. 


The help information displays as follows. 


Using the SQL QueryjDML Language 


sql> help select 


-- select 


The 'select' clause introduces every query. 
It has the following form: 


select {field or expression} [{field or expression}, ... J 
from {record type} [{record type} •.•. J I 


Note that a 'from' clause is also required for a valid query. 


The slash character (I) must end every query. 
If you don't enter a 
slash at the end of your query. 
SQL doesn't know you are finished. 


Suppose there were a record type named' 'emp" 
in the data base. You 
could select all the fields for all records of this type with the 
following query: 


select • from emp I 


To see a list of the valid record types. enter 'records' (a preceding 
'help' is not required}. 


To list all the fields for a given record type. enter 'fields <record-type>'. 


o 
STEP 
4: 


Action: 


Effect: 


sql> records 


Select the third type of help. 
Enter the records keyword. 


A list of the valid record types displays. 


manf 
model 
item 
customer 
orders 


o 
STEP 
5: 


Action: 


Effect: 


Select additional information on the third type of 
help. 
Enter separate queries with the keyword, fields, 
and the record type names, man!, model, and item. 


A list of the fields in each record type displays. 
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sql> fields manf 


NAME 
TYPE 
LENGTH 


Manufactursr_ID 
INTEGER 4 
Name 
STRING 
35 
Address 
STRING 
30 
City 
STRING 
20 
State 
STRING 
2 


Zip_Code 
STRING 
5 


sql> fields model 


NAME 
TYPE 
LENGTH 


Model_Number 
LONG 
7 


Manufacturer_ID 
INTEGER 4 
Description 
STRING 
30 


sql> fields item 


NAME 
TYPE 
LENGTH 


Serial_Number 
LONG 
9 
Jo'.oc1el-Number 
LONG 
7 
Manufacturer_ID 
INTEGER 4 


Acqnisition-Date 
DATE 
2 


SalesJrice 
AMOUNT 
5 


Order_Number 
LONG 
9 
PurchaseJrice 
AMOUNT 
5 
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6.2 SELECTING RECORDS 


You can select all the fields for a record type by using the SQL 
query select e. The asterisk (e) tells SQL to list all fields. 


EXERCISE: 
List all the model records in "the data base. 


sql> select • 
sql> from model/ 
recognized qneryl 


Model-Number!Manufacturer_lD\Description 


1001\ 
10021 
10031 
550711 
551711 
552711 
55371! 
10011 
1002! 
611171 
711171 
811171 
91117\ 
10111 
1012\ 


100\1/2" 
socket wrench 
10013/4" 
socket wrench 
10011/2" 
open end wrench 
10111/2" 
socket wrench 
10111/2" 
box end wrench 
101 1combination pliers 
1011needle nose pliers 
1021vis8 grips 
102 1leather mallet 
103\3" 
Phillips screwdriver 
10313" 
slotted screwdriver 
10316" 
Phillips screwdriver 
10316" 
slotted screwdriver 


104 1combination pliers 
10411/2" 
socket wrench 


You can select specific fields by listing the ones you want. 
You can 
also select a subset of records by using the where clause. 
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EXERCISE: 
List the manufacturer number, name, and address of 
each manufacturer whose ID number is greater than 
100. 


sql> select Manufacturer_ID, Name, Addreee 
sql> from manf 
sql> where Manufacturer_ID > 100/ 
recognized queryl 


NumherlName 
1Address 


101 IPrecision Tool Co. 
1021A 
~ H Industries, Inc. 
103 1Grover Parts and Supplies 
104 IThe Tool Depot 
105!BHP Ltd. 


12600 West 16th Street 
12434 Evergreen Ave. 
19462 Jackson Road 
17562 Orange Dr. 
117385 Weatherby Rd. 


Queries must be typed in exactly right; so it is likely you will make a 
mistake once in a while. When you misspell a keyword, record type, 
or field name, or enter a query that doesn't make sense, SQL displays 
a message that explains the nature of the error. You can, however, 
easily correct a mistake in a query. 


Suppose, for example, you enter the word "Manufacturer" as 
"Manuffacturer" in the select clause. An error message displays. 


sql> select Manuffacturer_ID, Name, Address 
sql> from manf 
sql> where Manufacturer_ID > 100 / 
Invalid field: Manuffacturer_ID 


You don't need to enter the query again because SQL saves the last 
.query. 


You can correct the error by using the SQL edit function. 


sql> edit 


The edit function uses vi, the Berkeley yisual editor, as the standard 
editor. Your screen form, then, displays as follows. 
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select Manuffacturer_ID. 
Hame, Addrea8 
from manf 
where Manufacturer_ID 
> 
100 / 


-/tmp/plOOnnnn- 
3 lin••• 
S9 characters 


Now you can use the editor to: 


1. Delete one "r' in the word "Manuffacturer." 


2. Write the file to disk. 


3. 
Return to SQL. 


You can restart the corrected query by using the restart keyword. 


sql> restart 
recognized query I 


101 IPrecision Tool Co. 
1021A & H Industries. Inc. 
1031Grover Parts and Supplies 
1041The Tool Depot 
1051BHP Ltd. 


1Addrese 


12600 West 16th Street 
12434 EVergreen Ave. 
19462 Jackson Road 
17562 Orange Dr. 
'17385 Weatherby Rd. 


The saved query works as if you entered it at the terminal. 


Suppose you like this query and want to use it later. Return to the 
editor as follows and write this temporary file to a file name in your 
directory. Then exit from the editor. 
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sql> edit 


select 
~nufactur8r_ZD, Skm., 
Mddr••• 
from manf 


....here :Dnufacturer_ID » 
11)0 // 


You can use this query again by running saved-query with the start 
keyword. 


sql> start saved-query 
recognized query I 


Number IName 


101 1Precision Tool Co. 
1021A & H Industries. Inc. 
103 IGrover Parts and Supplies 
1041The Tool Depot 
10SlBHP Ltd. 


IAddress 


12600 West 16th Street 
12434 Evergreen Ave. 
19462 Jackson Road 
17562 Orange Dr. 
117385 Weatherby Rd. 


The where clause has several special features that simplify queries. 
One such feature allows you to specify that a number. date, or 
amount must be between two values. 


Suppose you want to select each item whose sales price is between 
three and ten dollars. 
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Other query languages require the following statement. 


Sales-Price >= 3.00 and Sales-Price <= 10.00 


SQL, though, requires only a simple expression as the following 
exercise shows. 


EXERCISE: 
List the sales price of each item whose cost is 
between three and ten dollars. 


sql> select Sales-Price 
sql> from item 
sql> where Sales-Price between 3.00 and 10.00/ 
recognized queryl 


Sales-Price 


9.50 
5.50 
3.19 
8.75 
6.89 
9-.75 
9.75 
9.75 


Notice there are duplications in the list of sales prices. 


You can eliminate duplications and list distinct prices by using the 
unique keyword. 
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EXERCISE: 
List the unique sales price of each item whose cost is 
between three and ten dollars. 


sql> select unique Sales-Price 
sql> from item 
sql> where Salee-Price between 3.00 and 10.00/ 
recognized query I 


Sales-Price 


3.19 
5.50 
6.89 
8.75 
9.50 
9.75 


You can also perform complex selections. You accomplish this by 
using compound boolean expressions with the where clause. 


Simple expressions are connected using the and and or keywords. 
You can control the evaluation of the expression by using square 
brackets ([ ]). You enter the brackets before and after the parts of 
the expression you want to evaluate first. 


EXERCISE: 
List the serial number, manufacturer number, and 
sales price of each item whose manufacturer ID is 
either 101 or 103. Include each item, whose cost is 
seven dollars or less. 


sql> select Serial-NUmber. Manufacturer_ID. Sales-Price 
sql> from item 
sql> where [Manufacturer_ID • 101 or Manufacturer_ID • 103] and 
sql> 
Sales-Price <. 7.00 / 


recognized queryl 


Serial-NUiUber1 Manufacturer_ID1 
Sales-Price 
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10061 
10081 
10091 
10101 
10111 


1011 
1031 
1031 
1031 
1031 


6.89 
2.35 
2.69 
2.89 
3.19 
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6.3 USING ARITHMETIC EXPRESSIONS 


You can calculate numeric values by using the standard arithmetic 
operators: +, -, ., and /. 


Arithmetic expressions can include both constants and fields. You 
can use all field types, except STRING and COMB. Arithmetic 
expressions can be used wherever a simple field is allowed in the 
select, where, and having clauses. 


EXERCISE: 
List the model number, sales price, purchase price, 
and "mark-up" of each item whose manufacturer 
number is 103. The mark-up equals the sales price 
minus the purchase price. 


sql> select Model-NUmber, Sales-Price, Purchase-Price, 
sql> 
Sales-Price - Purchase-Price 


sql> from item 
sql> where Model-NUmber • 
1031 


recognized queryl 


Model_NUmber 1 
Sales-Pricel Purchase-PriceISales-Price-Purchase-Price 


911171 
911171 
611171 
611171 


3.191 
2.891 
2.691 
2.351 


2.201 
3.001 
2.001 
2.201 


0.99 
-0.11 
0.69 
0.15 


You can also use DATE fields in calculations, because they are 
stored in integer format. 


Suppose you want to locate each item that was added to inventory at 
least one week before a given date. 


6-13 


UNIFY Tutorial 


EXERCISE: 
List the serial number, acquisition date, and the date 
one week before the acquisition of each item whose 
acquisition date is more than one week before 
2/22/84. 


sql> select Serial-Number, Acquisition-Date, Acquisition_Date + 7 
sql> from item 
sql> where Acquisition-Date + 7 
< 2/22/84 / 


recognized query I 


Serial-NUmberIAcquisition-DateIAcquisition-Date+7 


10071 
10081 
10101 
10121 
10131 


01/19/841 
01/15/841 
01/15/841 
02/08/841 
02/08/841 


01/26/84 
01/22/84 
01122/84 
02/15/84 
02/15/84 


You can also use parentheses to form expressions. This allows you to 
control the computation order of a complex arithmetic expression. 


The system calculates expressions inside parentheses before 
caiculating expressions outside the parentheses. 


EXERCISE: 
List the serial number, sales price, purchase price, 
and the formula (Purchase..-Price + 2) • 0.75 of each 
item whose sales price is greater than the formula 
price. 


sql> select Serial-NUmber, Sales-Price, Purchaee-Price. 
sql> 
(Purchaee-Price + 2) 
" 0.75 
eql> from item 
eql> where Salee-Price > (Purchaee-Price + 2) 
" 0.75 1 


recognized queryl 


Serial-Numberl 
Salee-Pricel Purchaee-Pricel(Purchase-Price+2)"0.75 
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10011 
10021 
10031 
10041 
10051 
10061 
10071 
10111 
10131 
10141 


9.751 
9.751 
9.751 
10.251 
10.251 
6.891 
8.751 
3.191 
9.501 
15.001 


7.251 
7.351 
7.251 
8.901 
9.251 
6.001 
5.251 
2.201 
9.231 
13.231 


6.94 
7.01 
6.94 
8.18 
8.44 
6.00 
5.44 
3.15 
8.42 
11.42 


( 
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6.4 ORDERING OUTPUT 


You can specify the order of query output by using the order by 
clause. 


The default sort order is ascending, from lowest to highest. This 
means STRING fields are sorted in alphabetic sequence. 


EXERCISE: 
List each model, sorted by description. 


sql> select • 
sql> from model 
sql> order by Description/ 
recognized query I 


Model-Number IManufacturer_ID 1Description 


55171 I 
10031 
10011 
1012\ 
550711 
611171 
71117\ 
10021 
811171 
91117\ 
10111 
552711 
10021 
55371\ 
10011 


10111/2" 
box end wrench 
100\1/2" 
open end wrench 
10011/2" 
socket wrench 


10411/2" 
socket wrench 
101\1/2" 
socket wrench 
10313" 
Phillips screwdriver 
10313" 
slott~d screwdriver 
100.13/4" 
socket wrench 
10316" 
Phillips screwdriver 
10316" 
slotted screwdriver 
1041combination pliers 
101 \combination pliers 
102 1leather mallet 
1011needle nose pliers 
1021vis8 grips 


Besides ordering with a single sort, you can also create a multiple 
sort with more than one field. 


You can list some fields in ascending order and other fields in 
descending order. 


6-15 


liNIFY Tutorial 


EXERCISE: 
List the acquisition date and sales price of each item 
whose acquisition date is between 1/1/84 and 
3/1/84. Sort the items by descending date and 
ascending price. 


sql> select Acquisition-Date, Sales-Price 
sql> from item 
sql> where Acquisition-Date between 1/1/84 and 3/1/84 
sql> order by Acquisition-Date desc, Sales-Price asc 1 
recognized queryl 


Acquisition-Datel 


02123/841 
02/23/841 
02123/841 
02115/841 
02115/841 
02/15/841 
02/15/841 
02/15/841 
021151841 
02/08/841 
02/08/841 
01/19/841 
011151841 
01115/841 


Sales-Price 


10.25 
10.75 
15.00 
2.69 
3.19 
6.89 
9.75 
9.75 
9.75 
5.50 
9.50 
8.75 
2.35 
2.89 


6.5 USING AGGREGATE FUNCfIONS 


SQL has five built-in functions for calculating aggregate values: 
count(·), sum, min, max, and avg. 


These functions can be used in select and having clauses. 
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EXERCISE: 
Calculate the average sales price of each item in 
inventory. 


sql> select avgCSales-Price) 
sql> from item / 
recognized query I 


avgCSales-Price) 


7.64 


You can also calculate several aggregate functions in the same 
query. 


EXERCISE: 
List the maximum and minimum sales prices of each 
item in the inventory. 


sql> select maxCSales-Price), minCSal.s-Price) 
sql> from item! 
recognized query I 


max{Sales-Price) Imin{Sales-Prics) 


15.001 
2.35 


Besides listing field values, you can select the number of records that 
satisfied a query using the count function. 


The notation for the count function is as follows. 


. count (e) 


This allows consistency with other aggregate functions. 


EXERCISE: 
Count the total number of manufacturers. 


sql> select countCo) 
sql> from manf / 
recognized queryl 


count{o) 


6 
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6.6 GROUPING RECORDS 


You can calculate aggregate functions for groups of records with 
common characteristics using the group by clause. 
Consequently, when you use a group by clause without an aggregate 
function, the group by adds no further meaning to the query. 
The group by clause: 


• 
sorts selected records by indicated fields 
• 
calculates aggregate functions at each level break 


• 
results in sorted output 


EXERCISE: 
List the manufacturer number and average sales price 
of the items made by each manufacturer. 


sql> select Manufacturer_ID, avg(Salee-Price) 
sql> from it... 
sql> gronp by Manufacturer_ID/ 
recognized 
~.ryl 


Manufacturer_IDlavg(Sales-Price) 


1001 
1011 
1021 
1031 
1041 


11.06 
9.30 
8.75 
2.78 
7.50 


Notice this query lists only fields with common values for the group 
(each group in this case consists of items made by the same 
manufacturer). This is because each output line represents a 
computed group value. A list of the serial numbers for each item, 
then, is not possible in this query. 
You can group by several fields, which creates more level breaks in 
the result of the query. You can also qualify the records in the 
calculation by using a where clause. 
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EXERCISE: 
List the manufacturer number, model number, and 
total number of each like item whose cost is over five 
dollars. Break down the results by manufacturer ID 
and model number. 


sql> select Manufacturer_ID, Model-Number, count(·) 
sql> from item 
sql> where Sales-Price > 5.00 
sql> group by Manufacturer_ID, Model-Number/ 
recognized query I 


Manufacturer_ID1 Model-Number1 count(·) 


1001 
100\ 
1011 
1011 
1021 
1041 
1041 


10011 
10021 


550711 
552711 
10021 
10111 
10121 


3 
1 
2 
1 
1 
1 
1 


( . 


( 


6.7 USING NESTED QUERIES 


More complex questions than those we have asked so far can be 
answered by using nested queries. 


Nesting allows you to use the results of one query as input to another 
query. 


Suppose you want to locate the serial number of each item whose 
cost is the maximum inventory price. Using what you know so far, 
you can locate the maximum price of each item. To accomplish this, 
you enter: 


select max(Sales-Price) 
from item / 


Or, you can locate each item whose cost is a specific amount, such as 
ten dollars. To accomplish this, you enter: 


select SeriaLNumber 
from item 
where Sales-Price - 10.00 / 
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The only way. though, for you to locate the most expensive items is 
to: 


1. Locate the maximum sales price of all items in the first query. 


2. Use the maximum sales price as the constant in the second query. 
Nesting allows you to do this all in one step. 


EXERCISE: 
List the serial number, acquisition date, and sales 
price of each item whose cost is the maximum 
inventory selling price. 


sql> select Serial-NUmber, Acquisition-Dete, Sales-Price 
sql> frOlll itelll 
sql> where Sales-Price • select max(Sales-Price) 
sql> 
frolll itelll / 


recognized queryl 


Serial-NUmberIAcquisition-Detel 
Sales-Price 


'1J)141 
02/23/841 
15.00 


The evaluation of this query proceeds as follows. 


1. The inner query (select max (Sales-Price) from item) is 
performed to arrive at the maximum sales price result. 


2. The outer query is then performed using the results of the inner 
query. 


To understand nested queries, read from the innermost query to the 
outermost query. This is how SQL processes the query. 


You can also nest a query to several levels, not just one. 


Suppose you want to locate each item whose cost is the second 
highest sales price. 
. 


To accomplish this, you: 


1. Locate each item whose cost is the maximum sales price. 


2. Exclude these items and locate each remaining item whose cost is 
the maximum sales price. 


3. Locate each item whose cost is the new maximum sales price. 
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EXERCISE: 
List the serial number, acquisition date, and sales 
price of each item whose cost is the second highest 
sales price. 


sql> select Serial-NUmber, Acquisition-Dats. Salss-Prics 
sql> from itsm 
sql> where SalsS-Price • 
sql> 
select max(Sales-Price} 
sql> 
from item 
sql> 
where Serial-NUmber A. 
sql> 
select Serial-NUmber 
sql> 
from item 
sql> 
where Sales-Price • 


sql> 
select max(Sales-Price} 
sql> 
from item / 


recognized 'query I 


Serial-NUmberIAcquisition-Datel 
Sales..Price 


10051 
02/23/841 
10.75 


l 


To understand this query, start from the innermost query. The query 
locates the maximum sales price among all items. 


select max(Sales-Price) 
from item / 


The result of this query is the amount 15.00. 
The next query locates the serial number of each item whose cost is 
15.00. The interpretation of this query is as follows. 


select SeriaLNumber 
from item 
where Sales-Price - }S.OO / 


The result of this query is the serial number, 1014. 
The next query locates the maximum sales price of each item, except 
the item with serial number 1014. Substituting this value causes the 
query to read as follows. 


select max(Sales-Price) 
from item 
where SeriaLNumber 
A .. 1014 / 


The result of this query is the amount 10.75. 
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The final query locates the serial number, acquisition date, and sales 
price of each item whose cost is this price. The final query then 
reads as follows. 


select SeriaLNumber, AcquisitioD-Date, Sales-Price 
from item 
where Sales-Price = 10.75 / 


6.8 USING THE HAVING CLAUSE 


You can select some groups formed by a previous group by clause 
and reject others using the having clause. 


The basis of this selection is the result of an aggregate function in 
the having clause. 


EXERCISE: 
List the model number and average sales price for 
models having an average sales price of more than six 
dollars.- 


sql> select ~el-NUmber. avq(Salee-Pricej 
sql> from item 
sql> qroup by Model-NUmber 
sql> havinq avq(Sales-Pricej > 6.00 I 
recognized queryI 


Model-NUmberlavq(Sales-Pricej 


10011 
10021 
10121 
550711 
55271 1 


9.75 
11.88 
9.50 
10.50 
6.89 


Suppose that having found the models selling for an average price of 
more than six dollars, you now wanted to list the individual items. 
You accomplish this by changing the previous query to return only 
the model number. You can then nest this query in a second query 
that lists the other information. 
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EXERCISE: 
List the serial number, model number, sales price, 
and acquisition date of each model whose cost is more 
than an average six dollars. Order the results by 
model number. 


sql> select Serial-NUmber, Model-NUmber, Sales-Price, Acquisition-Date 
sql> from item 
sql> where Model-NUmber • 
sql> 
select Model-Number 


sql> 
from item 


sql> 
group by Model-NUmber 


sql> 
having avg(Sales-Price) 
> 6.00; 
sql> order by Model-NUmber / 
recognized query I 


Serial-NUmber1 Model-Number1 
Sales-PriceIAcquisitioD-Date 


t. 


<- 


10011 
10011 
9.751 
02/15/84 
10021 
10011 
9.751 
02/15/84 
10031 
.10011 
9.751 
02/15/84 
10071 
10021 
8.751 
01/19/84 
10141 
10021 
15.001 
02/23/84 
10131 
10121 
9.501 
02/08/84 


10041 
550711 
10.251 
02/23/84 
10051 
550711 
10.751 
02/25/84 
10061 
552711 
6.891 
02/15/84 


Notice the inner query ends with a semicolon. The entire query is 
valid with or without the semicolon. With the semicolon, the order 
by clause goes with the outer query. Without the semicolon, the 
order by clause goes with the inner query. SQL would then 
determine the result of the outer query's order. 


You can also use the having clause with a where clause. The 
processing of queries like this proceeds as follows. 


1. The where clause selects the qualifying records. 


2. The group by clause forms the groups. 


3. The having clause selects the qualifying groups. 
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EXERCISE: 
List the model number and item count of each model 
with at least two items whose cost is more than five 
dollars. 


sql> select Model_NUmber. countC·) 
sql> from item 
sql> where Sales-Price > 5.00 
sql> group by Model-Number 
sql> having countC·) 
> • 2/ 
recognized query I 


Model-Numberl countC·) 


1001 I 
3 


10021 
2 


550711 
2 


6.9 USING MULTIPLE FILE QUERIES 


Up to this point, all the queries have involved only one record type. 
You can, however, list fields from several record types in·a single 
query. 
Queries that list fields from several record types are join queries. 
These queries combine, or "join," different record types. 


You can list each record type in the join query in any convenient 
order in the from clause. SQL then determines the most efficient 
selection and qualification method. 
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EXERCISE: 
List the model number, model description, and 
manufacturer name of each model in the inventory. 


sql> select Model_Number, Description, 
Name 


sql> from manf, model 
sql> where manf.Manufacturer_ID • 
model.Man~facturer_IDI 


recognized query I 


Model-NumberlDescription 


100311/2" 
open end wrench 


100213/4" 
socket wrench 


100111/2" 
socket wrench 


55371 Ineedle nose pliers 
55271 Icombination pliers 
5517111/2" 
box end wrench 


5507111/2" 
socket wrench 


1002 Ileather mallet 
10011vise grips 


9111716" 
slotted screwdriver 


8111716" 
Phillips screwdriver 
7111713" 
slotted screwdriver 


6111713" 
Phillips screwdriver 
101211/2" 
socket wrench 


1011 1combination pliers 


IName 


IRH Smith Manufacturing 
IRH Smith Manufacturing 
IRH Smith Manufacturing 
IPrecision Tool Co. 
IPrecision Tool Co. 
IPrecision Tool Co. 
IPrecision Tool Co. 
IA & H Industries, Inc. 
IA & H Industries, Inc. 
IGrover Parts and Supplies 
IGrover Parts and Supplies 
IGrover Parts and Supplies 
IGrover Parts and Supplies 
1The Tool Depot 
IThe Tool Depot 


\. 


l. 


The where clause specifies how to perform the join. 


Here, we are matching manufacturer and model records based on the 
common field manufacturer ID number. In this data base design, 
there is an explicit relationship that optimizes this join. However, 
SQL does not require that any particular access method exists - 
it 
will choose the best one available. The only difference will be in the 
speed of the operation. 


You can also join more than two record types at the same time using 
SQL. 


To accomplish this, list the required record types in the from clause. 
Then, indicate their relationship in the where clause. 
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EXERCISE: 
List the model description, acquisition date, and 
manufacturer name of each item. Sort the results by 
acquisition date within description. 


sql> select Description, Acquisition-Date, Name 
sql> from item, model. manf 
sql> where model.Model-Number • item.Model_Number and 
sql> 
model.Manufacturer_ID • item.Manufacturer_ID and 


sql> 
model.Manufacturer_ID • manf.Manufacturer_ID 


sql> order by Description. Acquisition-Date 1 
recognized query I 


Description 


1/2" 
socket wrench 


1/2" 
socket wrench 


1/2" 
socket wrench 


1/2" 
socket wrench 


1/2" 
socket wrench 


1/2" 
socket wrench 


3" 
Phillips screwdriver 


3" 
Phillips screwdriver 


3/4" 
socket wrench 


6" 
slotted screwdriver 


6" 
slotted screwdriver 


combination pliers 
combination pliers 
leather mallet 


IAcquisition-Date!Name 


02/08/841The Tool Depot 
02/15/841RH Smith Manufacturing 
02/15/841RH Smith Manufacturing 
02/15/84IRH Smith Manufacturing 
02/23/84 IPrecision Tool Co. 
02/25/84!Precision Tool Co. 
01/15/84 IGrover Parts and Suppliee 
02/15/84 IGrover Parts and Supplies 
02/23/841RH Smith Manufacturing 
01115/84 IGrover Parts and Supplies 
02/15/84!Grover Parts and Supplies 
02/08/841The Tool Depot 
02/15/84 IPrecision Tool Co. 
01/19/841A 
~ H Industries, Inc. 


6.10 SENDING DATA TO AN ASCII FILE 


You can send the output of an SQL query to an ASCII file using the 
SQL into keyword. 


The query: 


select • from item into iteDLJistj 


places the results of the query in the iteDLJist file in the 'current 
directory. This file also contains the heading that the system 
normally generates at the beginning of each report. 
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Notice the into clause must follow the entire query block. It is 
always the last clause. The structure, then, of a longer query is as 
follows. 


select 
. 
from 
. 
where 
. 
group by ... 
having ... 
order by ... 
into filename / 


You may not want to include the descriptive heading if you use RPT 
or ASCII text processing filters, such as awk or sed, on the output 
file. 


You can eliminate the descriptive heading by using the lines keyword 
to set the number of lines per page. 


The default setting is 24 lines per page, or the size of a standard 
CRT screen. The setting controls the number of lines that print 
before a new heading prints. Setting lines to°suppresses the entire 
heading. The clause is as follows. 


sql> lines 0 


As a reminder, you must complete the steps in Sections 6.10, 6.11, 
and 6.12 to keep the data base of your application current. 
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o 
STEP 
6: 


Action: 


List the model description, item acquisition date, 
purchase price, and item count of each item in the 
inventory. Group these by model description, 
acquisition date, and purchase price. Send the 
output to the ASCII file, inv-list. 
Enter the following: 


sql> lines 0 
sql> select Description, AcquisitiOD-Date, Purchase-Price, count((··) 
sql> from item, model 
sql> where model.Model-Number • item.Model-NUmber and 
sql> 
model.Manufacturer_ID • item.Manufacturer_ID 


sql> group by Description, AcquisitiOD-Date, Purchase-Price 
sql> into inv_list 
~ 


Note: 
Be sure to include the lines 0 command. 
You will use this ASCII file again in Section 7. 
The exercises up to now have given you a sample of the query 
capabilities of SQL. There are many other SQL techniques available 
that help answer more complex data base questions. 


For more information, see the UNIFY Reference Manual. In 
particular, refer to the SQL section for examples and ideas on using 
this powerful query language. 


You're now ready to examine the Data Manipulation Language 
(DML) features of SQL. 


6.11 USING THE INSERT CLAUSE 


You can add new records to the data base using the DML insert into 
clause. 


This clause allows you to use ~onstant values (in the form of direct 
query input or an ASCII file) or values that are returned from a 
query as input data. 


You must specify only the primary key value. Otherwise, the value 
of the fields is set to standard default values: zeros for NUMERIC, 
FLOAT, AMOUNT, TIME, and STRING fields; null (-32768) for 
DATE fields. (Note: You can specify other default values using the 
"Advanced Field Attributes" facility. See the UNIFY Reference 
Manual for more details.) 
When you modify a set of records, SQL locks the information in the 
data base. This prevents several users from modifying the same 
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records at the same time. 


Steps 7 and 8 allow you to use the simplest method of insert. You 
add records to the data base from an existing file. 


The data files, cusLdata and order-data, come with your UNIFY 
Release in the directory •••jtutorialjbinjprep. The three dots stand 
for the directory where you install UNIFY. 


In Steps 7 and 8, the assumption is made that UNIFY is in the 
directory jusrjunify. When you enter these queries, however, use 
the name of your directory. 


D 
STEP 
7: 


Action: 


Insert the customer records from the cusLdata 
file into the new customer record type. 


Enter the following: 


sql> insert into customer: 
sql> from '/usr/unify/tutorial/bin/prep/cust-data' 
I 


recognized updatel 
3 record(s) added. 


Effect: 
The new customer records are stored in the data 
base. These records contain the following 
information: 


# 
Name 
Address 
Phone 
City/State 
Zip Code 
1 
Smith & Sons 
1234 State Street 
924-0075 
Hardware 
Wheatville CA 
95817 


2 
Creative 
9124 Industrial 
916·910-9999 
Manufacturing 
Blvd. 
Redding CA 92102 


3 
Reliable 
2113 Folsom Blvd. 
916-945·3434 
Construction 
Sacramento CA 
Co. 
92343 
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o 
STEP 
8: 


Action: 


Insert the order records from the order_data file 
into the new orders record type. 


Enter the following: 


sql> insert into orders: 
sql> fr01ll •lusr/unify/tutorial/bin/prep/order_data' 1 
recognized updatel 
3 record(s) added. 


Effect: 
The new order records are stored in the data base. 
These records contain the following information: 


Order 
Date 
Customer 
Number 
Ordered 
Number 
1 
04/02/84 
1 
2 
04/02/84 
3 
3 
06/28/84 
2 


You can also insert a record into the data base by listing the data in 
the SQL command. 


o 
STEP 
9: 


Action: 


Insert a new record into orders using 10 for the 
order number, 07/10/84 for the order date, and 1 
for the customer number. 
Enter the following: 


sql> insert into orders (Order-NUmber, Date_Ordered, Customer-Number): 
sql> 
< 10, 07/10/82, 
1 > / 
recognized updatel 
1 record(s) added. 
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Note: 
A list of field values with the ••< >" characters 
before and after the list is called a literal tuple. 


When the fields in a literal tuple are listed in the 
same order as in the record type, and when all the 
fields are present, the identifying field list may be 
omitted. 
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o 
STEP 10: 


Action: 


Insert three new model records. 


Enter the following: 


sql> insert into mo<1el: 
sql> 
< 3002, 
102, '2 ft level'>, 
sql> 
< 3490, 
102, 'right angle iron'>, 
sql> 
< 4209, 
102, 'combination pliers'> / 
recognized updatel 
3 record(s) added. 


Besides using literal tuples, an insert clause can use the results of a 
query statement to obtain its data. 


Suppose there is a new record type in the data base, current. It 
contains the modeuum and description fields. 


And suppose you want to select the model information for the 
manufacturer "A & H Industries" and place it in this new record 
type. 


Use the following query. 


insert into current: 
select Model-Number, Description 
from mo<1el, manf 
where mo<1el.Manufacturer_ID • manf.Manufacturer_ID and 


Name. 'A & H Industries o ' 
/ 


sql> 
sql> 
sql> 
sql> 
sql> 
recognized updatel 
5 record(s) added. 


Note: 
This update doesn't actually work on the tutorial data base, 
since the current record type doesn't exist. 


6.12 USING THE UPDATE CLAUSE 


You can modify fields in existing records by using the update 
keyword. This DML clause allows you to specify updates with literal 
values, expressions, or query statements. 


A where clause that specifies what records the update applies to is 
not necessary. When the clause is left out, the update applies to all 
records of the stated type. 


The set keyword is used within the update clause to let you indicate 
what value to "set" the specified field to. 
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When you modify a set of records, SQL locks the information in the 
data base. This prevents several users from modifying the same 
records at the same time. 


o 
STEP 11: 


Action: 


Change a mistake in the recorded purchase price 
for: leather mallet, serial number 1014. Change 
the prices from $13.23 to $13.49. 


Enter the following: 


sql> update item 
sql> set Purchase-Price • 13.49 
sql> where Serial-Number • 1014 / 
recognized updatel 
1 record(s) updated. 


You can update a field using an expression, and you can change 
more than one field in a single update clause. 


o 
STEP 12: 


Action: 


Increase the sales price of all items in inventory by 
5% as a result of overhead expenses. 


Enter the following: 


sql> update item 
sql> set Sales-Price • Sales-Price • 1.05 / 
recognized updatel 
14 record(s) updated. 


With the addition of orders to the data base in Section 6.11, you're 
ready to assign each item an order number. 
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o 
STEP 13: 


Action: 


Using the SQL QueryjDML Language 


Place the correct order number in each item 
record. 


Enter the following: 


I. 


sql> update item 
sql> set Order-NUmber • 
1 


sql> where Serial-NUmber is in 
< 1001, 1003,1004, 
1006,1007,1010,1011,1012 >/ 
recognized updatel 
8 record(s) updated. 
sql> update item 
sql> set Order-NUmber • 2 
sql> where Serial-NUmber is in 
< 1008,1009,1013,1014 >/ 
recognized updatel 
4 record(s) updated. 
sql> update item 
sql> set Order-Number • 
3 


sql> where Serial-Number is in 
< 1002,1005 >/ 
recognized updatel 
2 record(s) updated. 


6.13 USING THE DELETE CLAUSE 


You can delete records from an existing file using the DML delete 
keyword. 


Only those records selected by the where clause are deleted. If the 
where clause is left out, SQL deletes all records for that type. 


When you delete a set of records, SQL locks the information in the 
data base. This prevents several users from modifying the same 
records at the same time. 
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o 
STEP 14: 


Action: 


Delete order number 10 from orders. 


Enter the following: 


sql~ delete orders 


sql~ where Order-NUmber • 10 / 
recognized updatel 
1 record(s) selected, 
1 record(s) deleted 


o 
STEP 15: 


Action: 


Delete the three models, 3002, 3490, and 4209. 
These models were added to the data base in 
Section 6.11. 


Enter the following: 


sql~ delete model 


sql~ where Model-Nnmber is in 
< 3002, 
3490, 4209 
~ / 


recognized updatel 
3 record(s) selected, 
3 record(s) deleted 


( 
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o 
STEP 16: 


Action: 


sql~ and 


Exit SQL. 


Enter the SQL end keyword: 


\. 
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7. RPT - 
THE REPORT PROCESSOR 


This section introduces the UNIFY report processor, RPT. RPT 
allows you to quickly and easily specify the format of multiple level, 
tabular reports using a nonprocedural language. The data for a 
report can come from an SQL or Query By Forms query, a user 
program, or an ASCII file. 
You can customize the format of the report - 
including field 
formats, headings, footings, column titles, and pagination - 
for each 
application. 
In this section, you will develop a report that uses most of the basic 
features of RPT. The next two subsections present the concepts of 
report writing, and introduce report writing terms. Remaining 
subsections take you through the process of building and running the 
report. 


7.1 FILES USED BY RPT 


The elements you need to produce a report include: 
• 
an input file that contains the data you want to format and 
summarize into a report 
The input file is an ordinary ASCII file that consists of identically 
formatted lines. Each line has a number of data fields that ends 
with a new-line character. 


• 
a report script file that contains the RPT commands describing 
the format of the input lines and the appearance of the report 
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RPT reads the data in the input file and uses the commands in the 
report script to produce the report. The following diagram shows the 
relationship of RPT with input files and report scripts. 


~L 
Off' 
USer 
Text 
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I 
I 
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7.2 RPT REPORT STRUCI'URE 


To understand how the report writing process works, it's best to know 
the structure of RPT reports and the names used for the various parts 
of a report. The best way to see this is to examine a report from the 
data base you developed in the previous sections. 
The example report groups inventory items by description, acquisition 
date, and purchase price. For each group of items, it lists the 
'acquisition date, purchase price, and number of items. At the end of 
the report is a count of all the items. 
The input file for this report comes from the SQL query you did in 
Section 6.10. Each line contains a field for the item description, 
acquisition date, purchase price, and the number of items with the 
same information. 
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Here is the RPT script for the report, followed by the actual report 
output. 


File: purchase. r 


inpg.t 
model. Description. 
item.Acquisition-Date. 
item.Purchase-Price. 
item-count [numeric 21 
sort Description. Acquisition-Date 
width 80 
header 
print 'PllRCHASE ACQUISITIONS' centered 
skip 
print .'Item Description'. 'Acquisition' in col 30 no newline 
print 'Purchase' in col ·n • 'Number' in col 61 
print 'Date' col 33. 'Price' col 48. 'of Items' col 60 
print 70[_] 
before Deecription 
print Description 
detail 
print Acquisition-Date in col 31 no newline 
print Purchase-Price in col 47 usinq 
'##.&Ji,.' no newline 
print: item-count in col 63 usinq '#&.' 
after Description . 
print '-_' col 63 
• 
print 'Total' col 55. total(item-count) col 63 usinq '#&.' 
print: 70[-1 
after report 
print 
col 62 
print 'Total Purchases' col 45. total(itam-count) col 62 usinq '##&.' 
end 
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PURCHASE ACQUISITIONS 


Item Description 


1/2 II socket wrench 


AcquiBition 
Date 


02/08/84 
02/15/84 
02/15/84 
02/23/84 
02/25/84 


Purchase 
Price 


9.23 
7.25 
7.35 
8.90 
9.25 


NUmber 


of Items 


1 
2 
1 
1 
1 


3 '1 Phillipe screwdriver 


3/4" socket wrench 


6 11 slotted ecrewdriver 


colllbination pliers 


01/15/84 
2.20 


02/15/84 
2.00 


02/23/84 
13.49 


01/15/84 
3.00 


02/15/84 
2.20 


02/08/84' 
5.75 


02/15/84 
6.00 


Total 
6 


Total 
2 


Total 


Total 
2 


Total 
2 


-----~-----------~---------------------------------------------------. 
leather mallet 


01/19/84 
5.25 


Total 


Total Purchase. 
14 


Notice that the report groups or sorts by description and acquisition 
date. (The result is also sorted by purchase price, since the input file 
was sorted this way.) 


Each field you sort by is called a sort key. The sort key can be a 
simple data base field or complex expression. The expression can 
consist of fields, constants, variables, arithmetic operators, and 
functions. 


7-4 


Using the Report PrOcessor 


The purposes of sorting are to: 


• 
rank items with different sort key values; that is, itemize sort 
keys in ascending or descending sequence 


• 
group items with the same sort key value; for example, group all 
combination pliers 
When the value of a sort key changes, a control or level break 
occurs. A control break separates groups of items with different sort 
keys. For example, when the item description changes from 3" 
Phillips screwdrivers to 3/4" socket wrenches, a control break occurs. 
RPT allows you to print and process before and after a control break. 
Suppose, for example, the control break from \6" socket wrenches to 
3" Phillips screwdrivers occurs. After the \6" socket wrench group, 
you can print the total number of grouped items. And before the 3" 
Phillips screwdriver group, you can print the item description. 
To accomplish this, you print the total in the after Description 
command-group, since the commands in this group are processed 
after the description changes. Similarly, you print the description 
itself in the before Description command-group, since the commands 
in this group are processed before a new set of input lines with the 
same description is read. 
In addition to the "grouping" or "sort" control break, there are five 
other types of control breaks: 


• 
detail control break. This is the lowest level break. It occurs 
when a new or "detail" line is read from the input file. At this 
level, you can print a line, perform a calculation, and total a 
number. 


• 
before report control break. This occurs at the beginning of the 
report. It's useful to print report headings or titles. 


• 
after report control break. This occurs at the end of the report. 
It's useful to print a grand total of the entire report. 


• 
header control break. This occurs at the top of each report page. 
It's useful to print a running title, date, time, or page number. 


• 
footer control break. This occurs at the bottom of each report. 
It's useful to print page numbers or notes. 
A control break, then, is the occurrence of an event. For example, 
when RPT detects a top-of-page. When the event occurs, the 
comma!).ds associated with the event are processed. These commands 
make up a command-group. The header command-group in this 
example is processed at the top of each page. 
. 
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Command-groups are: before and after report, before and after 
name, detail, header, and footer. 


Details on the structure of the report example (purchase.r) are 
presented in the following subsection. You have the opportunity to 
run the script in Section 7.4. 


As a reminder, you are at the UNIFY Main Menu. 


l(Jr.ainmanU] 
UNIFY aalaaaa 3.2 
UNIFY Main Manu 


1. 
D••ivn aDd Cr••~. & Xev 
D&~a B••• 


2. Craata or Modify 8craan Forma 


3. SQL - 
Qua~/DlIL Lanqu&qa 


5. Add, Modify or Dalata Manna 


6. Data Baa. D.aiqn Utiliti.a 


7. Syata. A4m1niatration 


8. Data Entry Scra.na 


10 JAB 1985 _ 14:22 ~ 


SELECTION: ,- 
".~__"'~~l".~iBi~ 
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o 
STEP 
1: 


Action: 


Effect: 


Start the editor. 


Enter a 4 to select "Edit SQL or RPT Command 
Files." 
The program starts the current editor without a 
file name. The screen displays as follows. 
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• 


7.3 PARTS OF AN RPT SCRIPT 


The main parts of an RPT script include the input, header, before and 
after name, detail, and after report sections. 


Input Section 


o 
STEP 
2: 


Action: 


inpllt 


Start the RPT report script. 
Enter the input section as follows: 


model.Description, 
item.Acquisition-»ats 
item.Purchass-Price, 
item-count [numsric 2] 


The input section specifies the format of each input line. RPT must 
know the name, data type, and length of each field in the input file. 


RPT uses the name to refer to the fields throughout the report script. 
There are two ways to assign a name to an input field. You can 
enter its data base field name (the long field name), or you can enter 
an arbitrary name with the field's type and length. The example 
input section uses both of these methods. 
When you use a data base field name, you must precede it with the 
name of the record type containing the field. You can reference the 
report field by its field name only in the other RPT sections. RPT 
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derives the type and length of these fields from the data base design. 


When you enter an arbitrary name with a type and length, you enter 
brackets on both sides of the type and length. You must enter a 
field data type; however, you need not enter the lengths for date and 
time. 
The valid data types are numeric, float, string, amount, date, and 
time. Report fields cannot be of type comb. 


Header Section 


o 
STEP 
3: 


Action: 


Add column headings to the report. 
Enter the header command-group as follows: 


inpa.t 
model. Description, 
item.Acquisition-Date, 
item. Purchase-Price, 
item-count [numeric 2] 


The header command-group processes the column headings of the 
report. The header output prints after the top margin on the first 
page when you do not use the before report command. You only use 
the header command once in an RPT script. 
The skip command leaves blank lines; one blank is the default. 


All report output is printed using the print command. The features 
of the print command include the ability to: 


• 
print character strings 


• 
suppress a carriage return 


• 
position output in columns 
• 
center a character string 
• 
print strings of repeated characters (70 dashes in this case) 
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WHEN you require... 
THEN use the... 
absolute positioning 
in col nn option 
the character string of the next print command 
no newline option 
to follow the current output on the same line 
the character string centered on the width of 
centered option 
the report, such as titles 
a change in the default width of numbers, 
using option 
amounts, or float fields 


For more information on the print command, see the UNIFY 
Reference Manual, Section 7.8.4. 
The word characters refers to any printable character. You can 
print headings, underlines, and unchanging information in a report 
using character string constants. 
There are two types of character string constants: 


• 
character string with single quotes 
• 
repeated characters with brackets 
Their format is as follows. 


'characters' 
and 
count [character] 


The quoted string (characters) describes a literal set of characters. 
You must enter the characters on a single line. The following are 
examples of quoted string constants. 


" 
'xyz' 
, 
, 


'Portland, OR' 


(the null string) 


(string with space characters) 


The repeated character format (count[character]) specifies the count 
or the number of times you want the character to print. Zero (0) is 
not a valid count. You must enter one printable character between 
the brackets. 
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You can enter long and difficult strings using this format. The 
following are examples of repeated character constants. 


3[\] 
is equal to '\\\' 
7['] 
is equal to ' "" 
, 
9[.] 
is equal to ' 
.' 
12[[] 
is equal to '[[[[[[[[[[[[' 
18[] 
is equal to ' 
20[-] 
is equal to'--------------------' 


For more information on strings, see the UNIFY Reference Manual, 
Section 7.4.5. 


Before name and After name Sectiona 


o 
STEP 
4: 


Action: 


input 


Add new sections to the report script. 
Enter the before and after command-groups as 
follows: 


model. Description, 
it.m.Acquisition-Dat., 
item.Purchase-Pric., 
it.m-count [nam.ric 2] 


header 


print 'PlJRCHASE ACGlO:ISIT:IONS' cent.r.d 
skip 
print 'Item D.scription', 'Acquisition' in col 30 DO n....lin. 
print ' Purchas.' in col 47 , 
' NDmber' in col 61 


print 'Dat.' col 33, 'Pric.' col 48, 'of It.ms' col 60 


III•• rint 70[-] 


The before Description command-group is processed before each new 
model description group. Consequently, the item description prints in 
the first column. 
The after Description command-group prints subtotals of each model 
group. These .commands are processed after RPT reads the last input 
line for each description group. 
In the after Description command-group, the total aggregate function 
calculates the sum by adding the appropriate field or expression of 


7·10 


- 


Using the Report Processor 


each line in the previous group. You only use aggregate functions, 
then, in after command-groups. For information on aggregate 
functions, see the UNIFY Reference Manual, Section 7.4.6. 


Detail Section 


o 
STEP 
5: 
Action: 
Add the detail section. 
Enter the information as follows: 


input 
model.Description. 
itsm.AcquisitiOD-Date. 
item.Purchase-Price. 
itsm-count [numeric 2) 
header 


print ' l'tlRCHASE ACQUJ:SJ:TJ:ONS' centered 
skip 
print 'J:tem Description'. 'Acquisition' in col 30 no newline 
print 'Purchase' in col 47 • 'Number' in col 61 
print 'Date' col 33. 'Price' col 48, 'of Items' col 60 
print 70[-) 
before Description 
print Description 


aftsr 
Des~iption 


print '--' col 63 
print 'Total' col 55. total(itelll-countl col 63 using '#&.' 
print 70[_] 


The detail command-group is processed for each line in the input file. 
It prints the detail lines of the report and performs detail 
calculations. You only use this command-group once in a report 
script. 
In the detail command-group, the print commands illustrate printing 
a value with a using format specification. This format prints the 
purchase price as an amount with "floating" blanks, a decimal point, 
and two digits of precision. 


Numeric, float, and amount fields normally print in a default field 
width. The defaults are as follows. 
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FIELD 
DEFAULT 
numeric 
nine spaces wide 
amount 
ten spaces wide 
float 
16 spaces wide 


You can change the width of the fields with the using option and a 
format template. 
The format template consists of special characters, one for each 
position in the field width. The special character indicates what 
prints at that position. 
The following describes the special characters for numeric and 
amount fields. When you read the descriptions, picture the format of 
a field as printing from right to left. 


II 
If there is a digit in this position, priut the digit. 
Otherwise, print a blank. This pads a numeric field with 
blanks on the left. 


& 
If there is a digit in this position, print the digit. 
Otherwise, print a zero. This pads a numeric field with 
zeros on the left. 


• 
If there is a digit in this position, print the digit. 
Otherwise, print an asterisk. This is useful when printing 
amounts on checks that have asterisks as pads on the left. 
S 
If there is a digit in this position, print the digit. 
Otherwise, print a dollar sign. If a dollar sign has already 
been printed, print a space. This prints either a fixed or 
floating dollar sign. 
+ 
If there is a digit in this position, print the digit. 
Otherwise, print a plus sign. If a plus sign prints, print a 
space. 
·If there is a digit in this position, print the digit. 
Otherwise, when this is a negative number, print a minus 
sign. If a minus sign has already been printed, print a 
space. 
If there is a digit in this position, print the digit. 
Otherwise, when this is a negative number, print a left 
parenthesis. If a left parenthesis, print a space. 


) 
If this is a negative number, print a right parenthesis in 
this position. 
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If there is a digit to the left of this position, print a 
comma. Otherwise, print a space. 


Print a decimal point in this position. 


After Report Section 


:0 
STEP 
6: 


, Action: 


Add the after report command-group. 


Enter the information as follows: 


inpl1t 
model.Description, 
item.AcquisitiOD-Date, 
item. Purchase-Price, 
item-count [numeric 2] 
header 
print ' PORCHASE ACGIO:IS:IT:IONS' centered 
skip 
print ':Item Description', 'Acquisition" in col 30 no newline 
print 'Purchase' in col 47 , 
'NwDber' in col 61 


print '»ate' col 33. 'Price' col 48. 'of :Items' col 60 
print 70[-] 


b,efore Description 
print Description 
detail 
print Acquisition-Ilate in col 31 no newline 
print Purchase...Price in col 47 using , II. &A.' no newline 
print itllJlL.count in col 63 using 'I&.' 
aftsr Description 
print '--' col 63 
print 'Total' col 55. total( it8111-count) col 63 using "I&.' 
print 70[-] 


The after report command-group is processed after RPT reads the 
last line in the input file. The total function calculates the sum of 
each iteDl-count field in the input file for a grand total. 


Miscellaneous Commands' 


\. 


o 
STEP 
7: 


Action: 


Add the final commands to the report script. 


Enter the information as follows: 
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inpl1t 
model. Description. 
item.AcqQisitiOD-Date. 
item.Purchase-Price. 
item-count 
numeric 2-- 
header 


print 
'PURCHASE: ACQOXSXTXONS' centered 


skip 
print 'Xtem Description'. 
'AcqQisition' in col 30 no newline 


print 'Purchase' in col 47 
• 
'Nlu1lDer' in col 61 


print 'Dat.' col 33. 'Price' col 48. 'of Xtems' col 60 
print 70[-] 


before De.cription 


print Description 
detail 


print AcqQisition...Date in col 31 no newline 
print Purchase..Price in col 47 USin9 '##.&A.' no newline 
print item-count in col 63 usin9 '#&.' 


after Description 


print '--' col 63 
print 'Total' col 55. total(item-count) col 63 usin9 '#&' 
print 70[-] 
after report 
print ' 
' 
col 62 
print 'Total Purchases' col 45. 
total(item-count) col 62 usin9 '##&.' 
- 


Note: This is-what the complete report looks like. 
The miscellaneous commands consist of specifying the sort order, 
setting a page width, and marking the end of the report script. You 
cannot use this type of command in a command-group. 
Consequently, this type of command is a non-command-group 
command. 
The sort command specifies the sort and order of fields. Sorting 
occurs befote any other report processing. When you do not use the 
sort command, there is no particular sequence to the output. You can 
only use the sort command once in a report script. 
The default order of the sort is ascending (lowest to highest). You 
can change the order to descending (highest to lowest) using the desc 
keyword. 
Sort expressions listed first (from left to right) are major sort 
expressions. Expressions listed last are minor sort expressions. 
Minor sort expressions do not affect the order of the major sort 
expressions. 
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In this example, Description is the major sort key, while 
AcquisitioR.-Date is the minor sort key. 


For more information on the sort command, see the UNIFY 
Reference Manual, Section 7.6.7. 


The width number command sets the width of a report page. The 
number refers to the number of columns or print positions available. 
The left margin width includes this amount. Therefore, if you 
change the left margin, you don't need to change the width. Since 
the default number is 132, the assumption is made that you're using 
line printer paper. 


For more information on the left margin command, see the UNIFY 
Reference Manual, Section 7.6.4. 


The end command indicates the end of the report script. RPT ignores 
all commands after end. 


o 
STEP 
8: 


Action: 


Save the report script. 


Save the text with the file name, purchase.r, as 
follows: 


C,· 


( 
--Width 80 


header 
print 
'PURCHASE ACQUISITIONS' centered 


skip 
print 'Item neacription'. 
'Acquiaition' in col 30 no newline 


print 
, Purcha•• ' 
in col .7 
• 
'Humber' in col 61 
print 'Date' col 33, 
'Price' col 48. 'of Item.' col 60 
print 70[-J 
before Description 


print Description 
dstail 


print Acquisition-Date in col 31 no newline 
print PurchAse_Price in col 47 
uain~ 
'##.~' no newline 
print item-count in col 63 
u8in~ 
'I~' 
after Description 
• 
print '--' col 63 
print 'Total' col 55, total(item-count) col 63 usinq ',&' 
print 70[-J 


after report 


print '----' col 62 
print 'Total PurchA.e.' col 45, 


totalCitem-count) col 62 uainq 
'#I~' 


end 


.......;W purchase.r8 
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o 
STEP 
9: 


Action: 
Effect: 


Exit from the editor and return to the active 
menu. 
Enter a q and press IRETURNI. 
The UNIFY Main Menu displays. 


7.4 RUNNING RPT FROM THE SHELL 


UNIFYa.l..... 3.2 
UNIFY It .in It .nu 
10JAJI 1985- 14:22 


2. C r.&t. 0 I' It 04ify S cr••n Forma 


3. sax. _ Q u.ry/DlII, L &nqu&9'. 


4. Edit S ax. or aP'l' C ollllll&nd Fil•• 


5. Add, It 04ify 0 I' 0 .l.t. It .nua 


6. o&t& B&8. O••i9'n Utilities 


7. S y.t... Admini.tr&tion 


8. 0 &t& Entry S cr••na 
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o 
STEP 10: 
Action: 
Effect: 


Exit to the operating system shell. 
Enter the command, sh, at the selection prompt. 
The shell prompt displays as follows. 


[ah] 


unify> • 


1JIIl:FY llaleaaa 3.2 


UIlIX Shell 


Using the Report Processor 


10 
JJtJf 
1985 
_ 
14: 22 


Notice that the prompt character changes. This reminds you that 
you're in a sub-shell. You are, however, still in the directory where 
you started. 


Using RPT from the shell requires two files: the input file, inv.-.list, 
and a script file, purchase.r. 


The shell syntax for processing RPT is as follows. 


RPT [-r] script [ [input file] [-] ] 


While the -r flag is optional, it directs RPT to remove the script file 
when the report completes.- This flag is for "SQL By Forms," which 
creates and uses a temporary file for the script. 
The input file is optional. It is the name of an ASCII file containing 
the data that require formatting. When you want to pipe the input 
-rile to RPT, use the - 
(dash) in place of the input file name. 
When you do not specify an input file either by name or with the 
dash, RPT compiles the script and prints an internal table report. 
This report lists the sizes of each important internal table and the 
number of elements the script uses in each table. 
When you suspect that a complex report exceeds an RPT table 
maximum, this report is useful. For information on setting the 
internal table sizes, see the UNIFY Reference Manual, Section 7.9.3. 
o 
STEP 11: 


Action: 


Effect: 


Process the RPT report. 


Enter the command as follows: 


RPT purchase.r inv-list 


RPT formats the data in the inv-list file according 
to the commands in the purchase.r file. 


The output displays as follows. 
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Item Description 


1/2" 
socket wrench 


Acquisition 


Date 


02/08/84 
02/15/84 
02/15/84 
02/23/84 
02/25/84 


Purchase 


Price 


9.23 
7.25 
7.35 
8.90 
9.25 


Number 
of Items 


1 
2 
1 
1 
1 


3" 
Phillips screwdriver 


3/4" 
.socket wrench 


6" 
slotted screwdriver 


combination pliers 


leather mallet: 


01/15/84 
02/15/84 


02/23/84 


01/15/84 
02/15/84 


02/08/84 
02/15/84 


01/19/84 


2.20 
2.00 


13.49 


3.00 
2.20 


5.75 
6.00 


5.25 


Total 
6 


Total 
2 


Total 


Total 
2 


Total 
2 


Total 
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Total Purchases 
14 
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7.5 RPT KEYWORDS 


Keyword 
Definition 
Reference 
Section 
after 
command-group identifier 
7.5.3 
after report 
7.7.1 
after name 
7.7.2 
amount 
report field type 
7.4.3 
and 
logical expression operator 
7.4.2 
avg 
aggregate function 
7.4.6.1 
before 
command-group identifier 
7.5.3 
before report 
7.7.3 
before name 
7.7.4 
begin 
if option 
7.8.1 
bottom 
non-commaIid-group command 
7.6.1 
bottom margin 
centered 
print option 
7.8.4 
col[umn] 
print option 
7.8.4 
comb 
report field type 
7.4.3 
count 
aggregate function 
7.4.6.1 
date 
report field type 
7.4.3 
desc 
sort option 
7.6.7 
detail 
command-group identifier 
7.7.5 
else 
if option 
7.8.1 
end 
non-command-group command 
7.6.2 
float 
report field type 
7.4.3 
footer 
command-group identifier 
7.7.6 
page option 
7.8.3 
header 
command-group identifier 
7.7.7 
. page option 
7.8.3 
hour 
built-in time variable 
7.4.4.3 
if 
command-group command 
7.8.1 


C 
condition operator 
7.4.5.2 
in 
print option 
7.8.4 
input 
non-command-group identifier 
7.6.3 
left 
non-command-group command 
7.6.4 
left margin 
length 
non-command-group command 
7.6.5 


( 
margin 
non-command-group command 
max 
aggregate function 
7.4.6.1 
min 
aggregate function 
7.4.6.1 
need 
command-group command 
7.8.2 
newline 
print option 
7.8.4 
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Keyword 
Definition 
Reference 
Section 
no 
print option 
7.8.4 
page option 
7.8.3 
not 
logical expression operator 
7.4.2 
numeric 
report field type 
7.4.3 
or 
logical expression operator 
7.4.2 
page 
command-group command 
7.8.3 
pageno 
built-in page number variable 
7.8.4 
print 
command-group command 
7.8.4 
report 
command-group identifier 
7.5.3.2 
after report 
7.7.1 
before report 
7.7.3 
separator 
non-command-group command 
7.6.6 
set 
command-group command 
7.8.5 
skip 
command-group command 
7.8.6 
sort 
. non-command-group command 
7.6.7 
string 
report field type 
7.4.3 
substr 
string expression operator 
7.4.5.3 
sum 
aggregate function 
7.4.6.1 
then 
if required keyword 
7.8.1 
time 
report field type 
7.4.3 
to 
set required keyword 
7.8.5 
today 
built-in date variable 
7.4.4.2 
top 
non-command-group command 
7.6.8 
top margin 
total 
aggregate function 
7.4.6.1 
using 
print option 
7.8.4 
where 
optional aggregate function 
7.4.6.1 
operator 


width 
non-command-group command 
7.6.10 
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7.6 USING RPT WITH OTHER UNIFY TOOLS 


UNIFY provides built-in interfaces to SQL and ENTER so you can 
easily create applications. Sections 9 and 10 show you how to do 
this. 
You can find further information in the UNIFY Reference Manual. 


For information on... 
See UNIFY Reference Manual... 
the SQLjRPT interface 
Section 6.3.6 
from the viewpoint of 
SQL 
RPT scripts for SQL 
Section 7.9.1 
By Forms 
the ENTER side of the 
Sections 5.1, 5.2.2, and 5.2.3 
ENTERjRPT interface 
RPT scripts for 
Section 7.9.2 
ENTER 
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Section 8 
Describing Programs to the Menu Handler 


( 


8. DESCRIBING PROGRAMS TO THE MENU HANDLER 


In Sections 6 and 7, you used SQL and RPT interactively to extract 
information from the data base. This section shows you how' to save 
these queries and reports, and connect them to the UNIFY Menu 
Handler. Then you can use them whenever you want. 
A shell script or compiled program that you can use as a command 
from the shell is called an executable . .You can register executables 
with the UNIFY Menu Handler and run them by entering their name 
at the menu selection prompt, or by choosing them from a menu. 
In this section, you will create two new executables: the "Purchase 
Acquisitions" (purchase) report and the "Inventory Item OVerview" 
(invitmo) report. You will then register these programs with the 
Menu Handler using the "Describe Program to System" option. 
The Purchase Acquisitions Report is the one you developed in 
Section 7. In this section, you will enter an SQL script, purchase.s, 
to select the items. The RPT script you entered in Section 7, 
purchase-r, will be used to format the report. 
The "Inventory Item Overview" (invitmo) report lists each item in 
the inventory. The report groups the items by type and manufacturer 
with details on their number and average sales price. The SQL 
script, invitm.s, selects the records. You run the report using the 
executable, INVITMO. 


A sample report produced by invitmo is as follows. 


1NVENTORY ITEM OVERVIEW 


Description 
IName 
I count(·) !aYq(Sales-Prics) 


1/2 t. socket wrench 
1/2" 
socket wrench 


1/2" 
socket wrench 


3" 
Phillips screwdriver 


3/4" 
socket wrench 


6" 
slotted screwdriver 
combination pliers 
combination pliers 
leather l1I&llet 


IPrecision Tool Co. 
IRK Smith llanufacturinq 
IThe Tool Depot 
IGrover Parts and Supplies 
IRK Smith llanufacturinq 
IGrover Parts and Supplies 
IPreciaion Tool Co. 
IThe Tool Depot 
IA 
~ K Industries. Inc. 


11.03 


10.24 
9.97 
2.65 
;5.75 
3.19 
7.23 
5.76 
9.19 
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The shell scripts in this and later sections assume that you are using 
the System III Bourne shell. If you're using another shell, the 
syntax can be different. For example, the syntax of the Version 7 
echo command is different from System III. 


As a reminder, you are still in the shell from Section 7. 


(al1J 
11Jll:PY Rele••e 3.2 


11Jll:X SI1.11 


unify> e 


o 
STEP 
1: 


Action: 


File: 
PURCHASE 


Create command scripts. 


Start up a text editor, such as vi or ed, to create 
the following files: 


File: 
~rchase.s 


lines 0 
select Description, AcquisitioD-Date, Purchase-Price, coantC o ) 
from it.., lIIOdel 
where lIIOdel.Jfodel-Number • it8lll.Jfodel-Number and 
lIIOdel.Jlanufacturer_:IIl • it8lll.Jlanufacturer_:ID 


group by Description, Acquisition-Date, Purchase-Price / 
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Pile: 
INVl:TMO 
echo; echo 
echo "Processing the rsport••• ·' 
echo 
echo 
> invitmo. i 
date 
» 
invitmo.i 
echo » 
invitmo. i 
echo " 
INVENTORY ITEM OVERVIEW" 
» 
invitmo.i 
echo » 
invitmo.i 
SQL invitm.e » 
invitmo.i 
echo "The outpa.t is beinq sent to the printer 
echo 
ipr invitmo.i 
echo "Report finished." 
rm invitmo. i 


Pile: invitm.s 


selsct Description, Name, count(o}, avq(Sales-Price} 
from manf, model, item 
where manf.Manufacturer_ID • modal.Manufacturer_ID and 


modal.Mod.el-Namber • itam.Hodel-Namber and 
model.Manufacturer_ID • item.Manufacturer-ID 
qroup by Description, Name/ 


l 


o 
STEP 
2: 


Action: 


o 
STEP 
3: 
Action: 
Effect: 
Reason: 


Add "executable" permission to the PURCHASE 
and INVITMO files. 
Exit from the editor, and enter the following 
"change mode" command (chmod(l)) at the shell 
prompt: 


chmod +x PURCHASE INVITMO 


Return to the UNIFY Main Menu. 
Press ICTRLI lQ]. 
You exit the sub-shell. 
You're ready to complete the final step in 
registering an executable. 
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I'rmainmenuJ 
UNIFya.l.a.a 3.2 


UNIFY Main Menu 


1.~::.i. 


10 JAN 1985 _ 1.:22 


1;& 


SELECTION: 7. 


2. 
Cr.a~. or Modify Scre.n 
For~ 


3. 
SQL -.Quary/DML Lanquaq• 


•. Edit SQL or RPT Command File. 


5. Add. Modify or D.l.t. M.nue 


6. Data Ba•• D••iqu Utilitie. 


7. Syat... Adminiatration 


8. Data Bntry Scr••n. 


o 
STEP 
4: 


Action: 


Effect: 


Mov.e to the "System Administration" (sysadmin) 
menu. 


Enter a 7 at the selection prompt as shown. 


The menu displays as follows. 


r·ya.dmin] 
UNIFY a.l•••• 3.2 


Sy.t... Admini.tr.tion 


10 JAN 1985 _ 1.:22 


1·1111_111 


2. Data Ba•• Maintenance 


3. s.curity Maint.nanc• 


•. cr.at.·or Modify H.lp Docum.ntation 


5. D••crib. Proqr&m to Sy.t... 


6. Proqr&m Loadinq 


7. Dat. Dictionary a.porta 
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o 
STEP 
5: 


Action: 
Effect: 


Describing Programs 


Select the "Describe Program to System" 
(execmnt) option. 
Enter a 5 at the selection prompt as shown. 
The screen form displays as follows. 


(e",ecmnt] 
UKIFT Releaaa 3.2 


Deaex1ha Proqra,. to Syete,. 
10 JAB 1985 _ 14:22 


( . 


EXECI1'I'ABLE'S NAIlS:~~ 
J a",acutahla data entry a.,..I 


usn SYSUCBV1. 
>""'*'"I 
, 


PROGRAKS: 
...4 NAB!: 
BEADING 
SCRES. 
DIREC'1'ORY 
0 0 


1 


:I 
3 
4 
5 
6 
7 
8 


9 


(I]HQUIRE. 
(A]DD. 
(K]ODIFT. (D]ZIoZU •• 


The "Describe Program to System" screen form allows you to 
inquire, add, modify, and delete not only executables but programs in 
the executables. 
An executable can contain multiple entry points that start up a 
different program. This, however, is usually applicable to custom 
programs, not command files. For information on this subject, see 
the UNIFY Reference Manual. 
There are two entry areas on this screen: the executable data entry 
area and the program data entry area. 
The operation prompt: 


[I]NQUIRE, [A]DD, [M]ODIFY, [D]ELETE 


allows you to select an operation mode for the program data entry 
area. 
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WHEN you want to... 
THEN select... 
view a registered executable 
i (inquire) 
register a new executable 
a (add) 
modify HEADING, SCREEN, and 
m (modify) 
DIRECl'ORY for the current 
executable; and add, modify, and 
delete programs 
delete the current executable and its 
d (delete) 
associated programs 


The Describe Program to System screen form has the following 
prompts. 


CD 
EXECUTABLE'S NAME. This is an eight character string 
that is the name of the file containing the executable. When 
you select a program in the executable, this file name is passed 
to the shell: 


® 
USES SYSRECEV ? 
A Y answer means the executable is 
expecting the standard argument list from the Menu Handler. 
This usually applies only to custom programs. 


An N answer means that the executable is not expecting any 
arguments. For more information on this subject, see the 
Programmers'Manual. 


® 
amd. This is where you enter an operation command for the 
current program while in the program data entry area. The 
cursor marks the current program. You can move the cursor up 
or down the column by pressing ICTRLI IDl or IRETVRNI. 
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The valid operation commands are as follows. 


WHEN you want to... 
THEN enter... 
add a program to the executable. This is only 
a (add) 
valid on the first empty line in the multiple 
line area. You must move the cursor to the 
first blank line to add a program. 
modify HEADING, SCREEN, or 
m (modify) 
DIREcrORY for the current program. 
When you want to modify the NAME, you 
must delete the line and add the name again. 
delete the current program 
d (delete) 
leave the multiple line data entry area and 
q (quit) 
position the cursor at the USES SYSRECEV 
prompt 


@ 
NAME. This is an eight character system name for a 
program in the executable. You enter this name in 
response to the menu selection prompt to access the 
program. 
If the executable is a custom program, and its name is an 
entry point to the executable, this name must be the same 
as the host language function name of the program. 


® 
HEADING. This is a 36 character string that displays on 
the second line of the screen when the program is running, 
and on menus where this program is a selection option. 


® 
SCREEN. This is the name of the screen form displayed 
before the program starts. This is an optional entry. 


(j) 
DIREcrORY. For custom programs, this is the name of 
the directory where the source code resides. The UNIFY 
program loading shell script (u/d) expects the archive 
containing the program to be in this directory. 
When you enter the directory name here, the relative path, 
••/sre/, is added as a prefix to the name. If you do not 
enter the directory name, u/d uses the first three 
characters of the program name as the directory name. 
Suppose, for example, the program name is ordlOO. u/d 
looks in ••/sre/ord for the archive containing ordlOO. 
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o 
STEP 
6: 
Action: 


Effect: 


Select add mode. 
Enter an a in response to the prompt at the bottom 
of the screen. 
The prompt erases and the cursor moves to 
EXECUTABLE'S NAME. 


[ ex.cmnt:] 
[A]DD 


UKlFY R.l•••• 3.2 


D••crib. Program to Sy.t.m 


10 JAB 1985 _ 14:22 


EXECUTABLB'S 1IAI!1l: 
lllVI'1'IlO 


USES SYSUCBV ? II 
PROGRAIIS: 


4 ..4 IIAI!1l 
IlBADIIIG 


o invit:Olo 


1 
2 
3 
4 
5 
6 
7 
8 


9 


o 
STEP 
7: 


Action: 
Effect: 
Note: 
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SCRBBV 
DIUC'1'ORY 


Add the executable, INVITMO. 
Enter INVITMO at the first prompt as shown. 
The executable is added to the data dictionary. 
The prompts USES SYSRECEV ? and NAME 
have defaults assigned to them. 


You can change a program name by deleting it 
and adding it again. 


(...:acmn~] 
(A]DD 


EXECU'l'ABLE'S IlAIlE: 
DlVITMO 


USES 
SYSRECEV ? • 


PROGRAMS: 
amd. 
IIAMS 
IIEAIlIllG 
milO 
invi~o 


1 
2 
3 
" 
5 
6 
7 
8 
9 


UNIFY !lela.a. 3.2 
• 


llaacri!:,. Pro<p:am to 
Sya~am 


SCREEll 
DIRECTORY 


Describing Programs 


10 JAll 
1985 
- 
14: 22 


0 
STEP 
8: 
Action: 


Reason: 


0 
STEP 
9: 
Action: 
Effect: 


Note: 


Position the cursor. 
Press IRETURN! to move the cursor to the amd 
column, or the data entry area. 
You're ready to enter a command to modify the 
program definition. 


Select modify mode. 


Enter an m in the amd column as shown. 
The cursor moves to the HEADING column. 


~ with other screens, IRETURNI moves the 
cursor forward, while ICTRLI IDJ moves it 
backward. 


When you press ICTRLI IDJ with the cursor in the 
HEADING column, the cursor moves back to the 
amd column. 
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[execmnt] 
[A]DD 


llIrIFY 1181.... 
3.:Z 
De.crib. 1':roqram to Sy.te.. 


10 J»l 
1985 
_ 
14::Z:Z 


EXECUTABLE'S 
NAME: 
IHVITllO 


USES 
SYSRECEV 
? • 


PROGRAllS: 
"Old 
NAME 
JlEAJ)IHG 


o :Lnvitmo 
Xnventory Ite.. Overview 


1 


2 
3 
4 
5 
6 
7 
8 
9 


SCREE. 
DIRECTORY 
- 


o 
STEP 10: 
Action: 
o 
STEP 11: 
Action: 


Add the heading for invitmo. 


Enter the heading as shown. 


Complete the entry for invitmo. 
Press ICTRLI IQ] to move the cursor to the amd . 
column. 


[oxeclOUt] 
[A]DD 


UIIIFY R.l•••• 3.:Z 


D••crib. Proqram to Sy.t... 


10 JAM 1985 
~ 
14:2:Z 


EXECUTABLE'S HAME: 
IHVITllO 


USES SYSRECEV ? H 
PROGRAllS: 
....d 
HAllE 
JlEAl)IHG 


o invitmo 
Inventory It... Ov.rvi.w 


q_1 


:z 
3 
4 
5 
6 
7 
8 • 


9 


8·10 


SCREEX 
DIRECTORY 


o 
STEP 12: 
Action: 


Effect: 


o 
STEP 13: 


Action: 


Effect: 


Reason: 


Describing Programs 


Leave the data entry area 
Enter a q as shown. 


The cursor moves to the USES SYSRECEV ? 
prompt. 


Clear the screen form. 


Press ICTRLI IDJ. 


The screen form clears for a new entry. 


You're ready to register PURCHASE. 


[.:...cmntj 
[AjDD 


uxtFY a.l•••• 
3.~ 


D••czi~. ProgT&e to Sy.t•• 


10 JAN 1985 _ 1.:22 


0 
STEP 14: 
Action: 


Effect: 


0 
STEP 15: 


Action: 
Effect: 


( 


r;XSCtl"l'ABLZ' S 1lAMZ: 
PU1\ClL\llB 
usr;s Sysazczv ? » 
paOGRAIIs: 
••4 IlAMZ 
lIBADI:HG 
scazr;Jf 
DI:azC'1'Oay 


o puzcbA.. 
PuxCbA.. Acquiaition Liatinq 


1 
2 
3• 
5 
6 
7 
8 
9 


Register PURCHASE. 


Repeat Steps 6 through 13. 
The final screen form displays as shown. 


Clear the screen form and return to the menu; 
Press ICTRLI lIIl until the menu displays. 
You now can run the PURCHASE and INVITMO 
executables from the Menu Handler using their 
names. 
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[aya..d.lllinj 
UNIFY R.l•••• 3.2 
Syat.& ~ni.~r.tion 


1. '!'ran.action LO'1qinq Statue 


2. 
Data Ba•• Maintenance 


3. S.curity Maint.nanc• 


10 JAM 1985 _ 1':22 


•. Cr.at. or Modify H.lp Docum.ntation 
5. 
_ 


6. 
Program Loadinq 


7. Data Dictionary R.port. 


SELECTION: invitmo. 
-------------- 
:;~,.;,.:,;v 


":"<::.::itf 


CJ 
STEP 16: 
Action: 
Effect: 


Select the executable, INVITMO. 
Enter invitmo at the selection prompt as shown. 


UNIFY sends the output from INVITMO to your 
printer. During the process, the screen displays as 
follows. 


[invit&oj 


Proc•••inq the report 
.~. 


UWIFY R.l.a•• 3.2 
Inventory Item Overview 


10 JAM 1985 _ 1 ':22 


Th. output i. b.ing ••nt to the printer 


R.port fini.h.d. 


When the report completes, the System Administration menu 
automatically displays. You're ready to run PURCHASE. 
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[sysadmin] 
1lIlIFY blea•• 3.2 
SyataR Adminiatration 


1. Transaction Loqqinq Status 


2. 
Data Ba.a Maintananca 


3. 8aeurity Maintananca 


Describing Programs 


10 
JAIf 1985 - 
14: 22 , 


SELECTION: purcha••- 


4. Cuata or Modify aalp IlocWllantation 


7. 
Data Dictionary llaporta 


Effect: 
Action: 


D 
STEP 17: 
Sel~ct PURCHASE. 
Enter purchase at the selection prompt as shown. 
The report displays and then returns you to the 
menu. 


Now you have seen how to save queries and reports and connect 
them to the Menu Handler. This ability is very important when you 
are developing an applica"tion. In Section 12 you will see how to put 
these options on a menu you create yourself. 


\. 


D 
STEP 18: 
Action: 
Reason: 


Return to the UNIFY Main Menu. 
Press the home command key. 
You're ready to query the data base using screen 
forms. 
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Section 9 
Query By Forms Using ENTER 


9. Query By Forms Using ENTER 
9.1 Using ENTER Screens to Perform Queries 
9-1 
9.2 Registering Reports with ENTER 
9-17 
9.3 Using the ENTER Report Options Screen 
9-29 


9. QUERY BY FORMS USING ENTER 


In previous sections, you entered records into the data base, and 
modified them using ENTER screen forms. 
In this section, you will use two more capabilities of ENTER. You 
will: 
• 
query the data base to retrieve data 
• 
generate reports using the data 


ENTER provides you a powerful and understandable method to 
retrieve data that is much easier to use than a keyword-based 
language. All you do is enter the fields on the screen form with the 
values you want. ENTER then constructs the optimal query to locate 
the data. When ENTER locates the reC'Ord, you can either update or 
delete it. 


You can also use ENTER with a report formatting program to 
produce reports of the query results. 


9.1 USING ENTER SCREENS TO PERFORM QUERIES 


To illustrate Query By Forms, you will use the "Inventory Item 
Maintenance" screen form. This form provides a view of the data 
base that you can perform interesting queries with. 


l 


o 
STEP 
1: 


Action: 


Effect: 


At the UNIFY Main Menu, select the "Create or 
Modify Screen Forms" option. 


Enter a 2 at the selection prompt. 
The "Create or Modify Scree~ Forms" menu 
displays as follows. 


[ocreena] 


SELECTION: 
i~.m_ 


1l1lIrY a.l..... 3.2 


Cr...~. or Modify Scr••n Forms 


3. 
a.qi.~.r Scr••n Form 
vi~h SQL 


4. 
Check Scre.D Porm Coordinat•• 


5. Di.pl..y 
Li.~ of Scr••n- 


6. 
T'••t 
SexeeDa 


,. Compil. Screen- 


8. 
~••tor. 
SCZ'••D 
~o Data Dictionary 


9. Create Default Scre.D Form 


10 JAM 1985 _ 
14:22 


o 
STEP 
2: 


Action: 
Effect: 


Select the "Inventory Item Maintenance" screen 
form. 
Enter ite~ at the selection prompt as shown. 
The screen form displays as follows. 


[:'tom] 


Serial Humber 
Manufacturer ID 
Model NUIlI!>.r 


Acquisition Oat.: 
sal.. Price 


Order NUIlI!>er 


Purchase Price 


UNIFY a.l•••• 3.2 


I!lV.~;t.ory I t..1Il Xaint.enaDca 


10 JAM 1985 - 
14:22 


[IJNaUI~. [A]DD. 
[M]ODIFY. 
[D]ELETE.- 
'-.:._-----------------------------" 
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o 
STEP 
3: 


Action: 


Effect: 


Query By Forms 


Select modify mode. 


Enter an m as shown. 


Modify mode displays in the top left corner and 
the following 'prompt displays. 


S.",ial Humb.", 
:. 


M.nufactur.", In : 
Mod.l Humb.", 


ACqUi.ition O.t.: 
Sal.. pxica 


Order Humber 


Purcha•• P",ic. 


UHIFY R.l•••• 3 .• 
Inventory It•• Maintenance 


10 J/oJf 1985 _ 14:22 


I\. 


B.'lin ••,u,ch [C'l'RL Xl, Cl••", fide! [C'l'RL Zl. Exit [C'l'RL Xl 


The operation prompt: 


Begin search [CI'RL E], Qear field [crRL Z], Exit [crRL X] 


allows you to select an operation mode for the ENTER screen. 
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WHEN you want to... 
THEN press... 
start the search with the 
crRL E. You can also press 
selection values you enter 
RETURN until you pass the 
last screen field. 
clear the current selec- 
crRL Z with the cursor at 
tion specification. For 
the field you want to clear. 
example, you enter a 
The specification erases and 
field value and then de- 
the query does not use it. 
cide it isn't right. 
terminate the current 
crRL X. This is a quick 
ENTER screen and re- 
way to leave an ENTER 
turn to the Menu Han- 
screen. 
dler 
. 


o 
STEP 
4: 


Action: 


Reason: 


Effect: 


Select an inventory item by its primary key. 
Enter 1002 after Serial Number, then press 
IRETURNI· 
This is a primary key access; ENTER can select 
the record immediately. 
The following screen form displays. 


(it... ] 
(!'I]ODIFY 


S.rial Humb.r 
: 1002 
Manufactur.r ID : 100 
Modol Humbor 
: 1001 


Acqui.itiou Dat.: 02/15/84 
Sal•• Pric. 
10.24 


Ord.r Humb.r 
: 3 


Purch.... Pric. 
'7.35 


UXIFY a.l•••• 3.2 
Inven1:ory It:e& Kaint.en.aDce 


U 
Smith ••uufocturinq 
1/2· aocket. ~.nch 


10 JAM 1985 _ 14:22 


o 
STEP 
5: 


Action: 


9-4 


Move the cursor to the Sales Price prompt. 


Press IRETURNI to advance. 


[ito.,] 
[M]OOIFY 


Sori&l Humb.r 
1002 


Manufacturor 10 : 
100 
Mod.l Humbor 
1001 


Acquioition Oato: 
02/15/84 
S&lo. Pric. 
10. 75 


Order N'waJ).:r: 


Purcha•• Pric. 
7.35 


UKIFY Rolo&&. 3.2 
Iuvontory Ito.. M&intonanco 


Rll llmith M&nuf&cturinq 
1/2- aocket vzench 


Query By Forms 


10 JAN 1985 - 
14:22 


CJ 
STEP 
6: 
Action: 


CJ 
STEP 
7: 
Action: 


Update the Sales Price field. 
Change the value to 10.75 as shown and press 
IRETURNI. 


Clear the screen form. 
Move the cursor back to the Serial Number 
prompt. 


Then press ICTRLI IIIJ to clear the screen form for 
a new query. 
ENTER provides two types of query capabilities: exact matching, 
and inexact or generic matching. 
Exact matching is when you enter exactly what you want the 
selected records to contain. To specify an exact match, you enter the 
field(s) on the screen just as you want to view them. You performed 
this type of matching in Step 4. 
Inexact or generic matching is when you enter special characters 
that specify ranges or patterns for the data to match. 
Examples of inexact matches are: 
• 
numeric and date ranges, such as numbers from one to 100, or 
dates froin 3/1/84 to 3/31/84 
• 
substring matches, such as strings that contain the pattern 
"Smith" 
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The construction of inexact matches with special characters is as 
follows. 


CHARACTER 
DESCRIPTION 


? 
The'wild character. The question mark 
matches a single character. When you want 
to locate each Smith, but don't know whether 
the spelling is "Smith" or "Smyth," you can 
use the specification Sm?th. 
• 
The wild string. The asterisk matches a string 
of characters no matter what the length. This 
includes zero length strings, or null strings. 
ENTER automatically appends an • at the end 
of each string specification by default. 
[...] 
The three dots stand for a set of characters 
that define a character class. The character 
class matches a single character that is a 
member of the class. 


The character class that represents upper case letters is as follows. 


[ABCDEFGIDJKLMNOPQRSTUVWXYZ] , 


You can specify a range of characters by separating two characters 
with a dash (-). Consequently, a more convenient way to represent 
all upper case letters is by [A-Z]. 
The character class that represents all upper and lower case letters is 
[a-zA-Z]. You can construct other classes similarly. 
You can construct inexact matches on non-string fields with the 
following set of expressions. The values .you supply are /1 and f2 . 
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EXPRESSION 
DESCRIPTION 
> /1 
The "greater than" operation. A match is any 
field value greater than the entered value. 
</1 
The Hless than" operation. A match is any 
field value less than the entered value. 


VI 
The logical "not" operation. A match is any 
field value that doesn't match the entered 
value. 
/1-/2 
The "range" operation. A match is any field 
value that equals or is between the entered 
values. This expression is equivalent to > =0: /1 
AND <-/2. 
V1-/2 
A match is any field value that is outside the 
range of entered values. This expression is 
equivalent to < /1 OR > /2. 


You can specify several of these selection values on a screen form. 
What ENTER does is to logically HAND" each specification together 
to produce a query. 
For example, locate each item record in the inventory whose 
manufacturer is RH Smith Manufacturing (#100) and whose 
acquisition date is 2/15/84. 


(ita"l 
(ltlOD1FY 


S.rbl Humber 
It.nuf.ctur.r 1D : 100 
Itod..l Humb.r 


Acqui.ition Dat.: 
O~/15/84 
sal.. Pric. 
: - 


Purclla•• Pric. 


OXlFY a.l•••• 
3.~ 
Invent.ory It.. M.aintenance 


10 JAJII 1985 _ 1 4:~;: 


( 


B.~in •••rch (CTJL El. Cl••r fi.14 (CTJL Zl. Exit (CTJL Xl 
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0 
STEP 
8: 
Action: 


Note: 


0 
STEP 
9: 


Action: 


Effect: 


Perform the first query. 


Enter the Manufacturer ID and Acquisition Date 
values as shown. 
After you enter 100, ENTER automatically 
completes the adjacent field. 


Begin the search. 


Press ICTRL! lID. 
The first selected record displays as follows. 


[item] 
[M]OD1FY 


s.rial Humb.r 
1001 


M"nufac~ur.r 1D 
100 
Mod.l Humb.r 
1001 


Acqui.i~ion D..~.: 
02/15/84 
sal.. Pric. 
10.24 


ord.r Humb.r 
: 
1 


Purcha•• Pric. 
7.25 


UNIFY a.l•••• 3.2 


1nv.n~orY 1~... M..in~.nanc. 


1Ul 
Smi~h M.nuf..c~urin'1 


1/2- aocket wrench 


10 JAN 1985 _ 14:22 


[H]EX'1', 
[P]REVI:OUS. 
[M]OD1FY. 
[S]'1'OP • 
• arched: 
4 .elected: 
3 current: 


The operation prompt you see now indicates what operations are 
currently valid. The valid operations depend on whether: 
• 
the current mode is inquire, add, modify, or delete 
• 
there are reports that associate with the screen form 
The six possible operations are as follows. 
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[N]EXT, [P]REVIOUS, [M]ODIFY, [D]ELETE, [R]EPORT, [S]TOP 


The [N]EXT, [P]REVIOUS, and [S]TOP operations display in every 
mode. The [M]ODIFY and [D]ELETE operations display only when 
in modify or delete mode, respectively. The [R]EPORT operation 
displays in inquire mode, provided there is a report formatting 
program associated with the ENTER screen. 
The responses to the operations are as follows. 


WHEN you want to... 
THEN select... 
display the next record in the set of selected 
n or RETURN 
records 
display the previous record in the set of 
p 
selected records 
modify the data in the current record 
m 
delete the current record from the data base 
d 
format the current set of selected records for 
r 
input to an associated report script. Up to 
eight different report scripts can be associated 
with a screen form. The reports display on the 
ENTER Report Options Screen (described in 
SectIon 9.3). 
clear the current set of selected records and 
s or crRL U 
clear the-screen form of data so you can 
perform a different query 


Below the operation prompt are the selected count registers. These 
registers are' as follows. 


NAME 
POSITIONS 
DESCRIPTION 
searched: 
nnnnnn 
the number of records ENTER 
examined to satisfy the query 
selected: 
nnnnnn 
the number of records ENTER 
selected 
current: 
nnnnnn 
the number of the record 
currently displayed on the 
screen form. The number 
ranges from one to the number 
of selected records. 


The query you just performed examined only four records. This is 
be.cause there is an explicit relationship between manufacturers and 
items. The relationship speeds up the search by reducing the 
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number of records that must be examined. 


The performance advantages of explicit relationships are not 
immediately apparent in a data base this small. But when there are 
tens of thousands of records in a file, then there can be speed 
increases tenfold over the use of indexes. 


o 
STEP 10: 


Action: 


Note: 


Advance to the next selected record in the set. 


Enter an n. 
You can also advance to the next record by 
pressing IRETURNI. 


itom] 
(!oI]ODIFY 


serial Numb.r 
1002 


M8nufac~ur.r ID : 100 
Model Numb.r 
1001 


Ac~ui.ition D.t.: 02/15/84 
S8l.. Pric. 
10.75 


Ord.r Numb.r 
: 3 


Purclla•• Pric. 
7.35 


UBIFY a.l•••• 3.2 
Inventory It... Maintenance 


1lH 
811d~h "nuf.cturinq 


1/2- aocke-t. 'WZench 


10 JItJ( 1985 _ 14:22 


(NlEXT. 
[P]REVIOUS. [KloDtFY. [S]TOP" 


.d: 
4 ••l.rt.d: 
3 
curr.n~: 
2 


9·10 


o 
STEP 11: 


Action: 
Note: 


Effect: 


Modify this record. 
Enter an m as shown. 
The current register shows that you are on the 
second record in the set. 


The cursor moves to the Serial Number prompt. 


[it...] 


S.ri.l HUIIlb.r 
Manutac1:.w:er II) 
Model HUIIlber 


1002 
100 
10001 


OXIFY R.l•••• 3.2 
Inventory Itelll Maintenance 


lUI SIIlith M.nuf.etw:inq 
1/Z· 
fIOck,et wrencb 


Query By Forms 


10 JAN 1985 - 
14:22 


Aequi.ition D.t.: 
02/15/84 


S.l.. Prie. 
10.24 


Order HUIIlb.r 


Purcha•• Price 
7.35 


.d: 
4 ••lected: 
3 current: 


o 
STEP 12: 
Position the cursor and change the price. 
Action: . 
Press IRETURNJ to move to the Sales Price 
prompt. 


( 


o 
STEP 13: 
Action: 


Then change the price back to 10.24 as shown. 


Redisplay the operation prompt. 
Press !RETURN! or ICTRL! IDl to move back to 
the Serial Number prompt. 


Then press ICTRL! II!! to redisplay the operation 
prompt at the bottom. 
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ite.. ] 
(lI]ODIFY 


Serial Humber 
Manu.factureX' 1D 
Model Numb.r . 


100:Z 
100 
10001 


1JlfIFY R.l.... 3.:Z 


. Inventory Itelll Kai:a:teD&DCe 


RB lImitl1 ManUfa<:turinq 
1/2- 8Qcket wrench 


10 JAN 1985 _ 14::Z:Z 


Acquisition D.t.: 
0:Z/15/84 


Salea Pric. 
10.:Z4 


Order Humb.r 
: 
3 


Purcha•• Pric. 
7.35 


(N]EXT. 
(P]REVIOUS. 
(M]ODIFY; 
(S]TOP .- 
aearched: 
• •• 1.c~.4: 
3 cuzrent: 


9·12 


o 
STEP 14: 
Action: 


Effect: 


Reason: 


Perform a different query. 
Enter an s as shown to clear the current set of 
selected records and to clear the screen form. 
The screen form clears and ENTER is ready for a 
new set of query specifications. 
You're ready to perform a query using the wild 
string character. 


(ite..] 
(ll]OOIFY 


Seri.l Humber 
ll.nuf.cturer 10 
llodel Humber 


Acquieition O.t.: 
Sa.les Price 


Order Humb.r 


Purcha.. Price 


UNIFY a.l•••• 
3.~ 
Inventory Ite. Kaintenanc. 


·plier•• 


Query By Forms 


10 JAM 1985 _ 
14:~2 


B.~in •••rch (CTRL E]. Cl••r fi.ld (CTRL Z]. £zit (CTRL X] 


c. 


o 
STEP 15: 


Action: 


o 
STEP 16: 


Action: 
Effect: 


Enter the fi~ld specification to select the records 
for all pliers in the inventory. 


Press IRETURNI to move the cursor to the field 
adjacent to the Model Number screen prompt. 


Then enter the string value as 'Shown. 


Complete the entry. 
Press IRETURNI. 
The cursor moves to the Acquisition Date prompt. . 


Since this is a secondary field, the "Selecting 
model" message displays as the model record 
selection is processed. 
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item] 
[MlODIFY 


serial Nwo.ber 
Manufa.cturer ID 
Model Ilumbar 


Acquisition Da.te: 
Sales PricR 


Order Humber 


PurchA•• Price 


UNIFY R.l•••• 3.2 


Inventory Item Maintenance 


·pliera 


10 JAN 1985 _ 14:22 


Begin .a.rch [CTRL El. 
Cl••r f1.14 [CTRL Zl. Exit [CTRL Xl 


.lectin 
model_ 


This specification selects the model records whose description 
in<;ludes the string "pliers." This is because ENTER automatically 
puts an asterisk (.) on the end of all string specifications. 
When you want to locate each model with a given description, such 
as "combination pliers," ENTER must scan the entire model file. If 
you perform this query frequently with a large model file, you may 
want to speed up the response time. 


You can do this by establishing a B-tree index on the description 
field. ENTER will then use the index to perform the query. For 
information on creating B-tree indexes, see the UNIFY Reference 
Manual, Section 2.1.7. 
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o 
STEP 17: 


Action: 
Effect: 


Start the item record search. 


~ress ICTRLI lliJ. 
ENTER scans only the item records for the 
indicated model using the model-item record 
relationship. 


The following screen form displays. 


(ito..] 
(M]OD1FY 


Seri.l Humber 
Manufacturer ID 
Model Humb." 


1006 
101 
55271 


UNIFY R.l•••• 3.2 


~nv.ntory It•• Maintenance 


Proci.ion Tool Co. 
combination plio". 


Query By Forms 


10 JAM 1985 _ 14:22 


Acqui.ition D.to: 02/15/84 
5.10. Prico 
7.23 


Order Number 


Purcho•• P"ico 
6.00 


(H]EXT. 
(P]REVIOUS. 
(M]OD1FY. 
(S]TOP • 
• arcbed: 
2 ••1.c~.4: 
2 current: 


o 
STEP 18: 


Action: 
Reason: 


Display the next record in the set and clear the 
screen form. 
Press IRETURNI. Then enter an s. 
You're ready to perform the last query. 


(u...] 
[M]OD1FY 


Serbl Humb." 
Manufacturer 1D 
Modol Humb"" 


UNIFY R.l•••• 3.2 


Inventory Item Maint.enance 


10 JAM 1985. 14:22 


ACqui"ition Dat.: 
5.1•• P"ic. 
Z.00.7.00 


Order Humber 
: • 


Purcha•• Prie. 


B.gin 
.oa"c~ (CTaL E]. Cl.a" fiold (CTaL Z]. Exit (CTaL X] 
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o 
STEP 19: 


Action: 


Effect: 


o 
STEP 20: 


Action: 


Effect: 


Select item records based on a price range. 


Enter the specification as shown. 


ENTER locates each item whose sales price is 
between $2.00 and $7.00. 


Start the record search. 


Press ICTRLI IS]. 


The screen form displays as follows. 


item] 
[M]ODIFY 


S.rial Numb.r 
: '008 
Manufactur.r ID : '03 
Mod.l Numb.r 
: 
~177 


Acqui.ition D.t.: 01/15/84 
5.1.. Pric. 
Z. 74 


Ord.r Numb.r 
: Z 


Purcllaa. Pric. 
Z. %0 


UKIFY R.l•••• 3.% 
IDVeuto.ry Item Maint.enance 


Grov.r Part••nd Su.ppl1.. 
3' Phillipa ecr.wdriv.r 


10 JMf 1985 - 
14:%% 


[N]EX~. 
[P]REVIOUS. 
[M]ODIFY. 
[S]~P' 
earehed: 
14 ••1ected: 
5 current: 
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Effect: 


Note: 


0 
STEP 21: 


Action: 


Effect: 


0 
STEP 22: 


Action: 


Effect: 


ENTER scans each item record to locate a match. 
In this case, the searched: count is 14 records. 


Again, if there were many model records, a B-tree 
index on the sales price would significantly 
improve the response speed. 


Page through the selected records. 


Press IRETURNI several times. 


Each record in the set is displayed in turn. 


Exit the ENTER screen form. 


Press ICTRLI ]XJ. 


You return immediately to the Menu Handler. 


Query By Forms - 


9.2 REGISTERING REPORTS WITH ENTER 


In the previous section, you saw how ENTER displays the records in 
a selected set one at a time. But you can also link an RPT report 
script with an ENTER screen, so you can print a report based on the 
selected set. 


This section explains how to link report scripts with ENTER screens. 
You use the option "Register Screen Form with ENTER" to do this. 


recr••na] 
UHZFY Rala.aa 3.2 


Create or Modify Screen Forma 


1. 
Paint Scre.n Forma 


3. 
Raqiater Screen Form with SQL 


4. 
Check Scre.n Form Coordinate. 


5. D1aplay L1at of Scraena 


6. T.at Scr••ns 


7. 
Compile Scr••n. 


8. a••tore Screen to Data Dictionary 


9. 
Cr••te 
D.f&~t Screen Form 


10 JAN 1985 _ 14:22 


SELECTION: • 


f-=::::~~~_~__Mt••~~IJ_r 


\. 


( 


o 
STEP 23: 


Action: 


Effect: 


Select the "Register Screen Form with ENTER" 
(ssqlmnt) option. 


Press IRETURNI to move the menu pointer to 
menu line 2. 


Then press the select command key. 


The following screen form displays. 
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10 JAN 1985 
_ 
14: 22 
(entmnt] 
UNIFY lIelu.. 3. 2 


Reqister Screen Form with EIlTERr-- 
~-_, 


8cr••n data 
entry area. 


:AC?GEE= ~cEo'RD:= 
.. ;:.~.:.=.'...'............-~ ~_~~_;;;;;;;;;;;;;;;~ 
• 
~ 
• - 
~ 
.%i$lW1ViWi®M 


FORMATTING PROGRAMS:@ 
HAIlE 
PARAMETERS 
TI'l'LE 
-ou'l'PU'l' 


(I]HQUlRE. 
(A]DD. 
(M]ODIFY, 
(D]ELE'l'E" 


report pz.'oqram 
entry and update 
are. 


report pcoqram 
p8qinq ern 


The "Register Screen Form with ENTER" option allows you to 
register one screen form at a time with ENTER. When you register a 
screen form with ENTER, the screen form becomes an ENTER 
screen. 


(You can register screen forms with either ENTER or SQL, but not 
both. For information on registering screen forms with SQL, see 
Section 10.3.) 


When you want to confirm the registration of existing screen forms, 
you can print a report using "Print List of Programs." For 
information on this subject, see the UNIFY Reference Manual, 
Section 3.2.7. 


There are two entry areas on this screen: the screen data entry area 
and the report program entry and update area. There is also a 
report program paging area. 


The operation prompt: 


[I]NQUIRE, [A]DD, [M]ODIFY. [D]ELETE: 


allows you to select an operation mode for the program. 
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WHEN you want to... 
THEN select... 
view an existing ENTER screen's data 
i (inquire) 
register screen forms with ENTER 
a (add) 
modify TARGET RECORD, HEADING, and 
m (modify) 
FORMATTING PROGRAMS for an existing 
ENTER screen 
remove the ENTER registration for a screen 
d (delete) 
form. The deletion does not affect the original 
screen form. The deletion does, however, 
remove references, such as menu listings. 


You can print a list of each menu in the system using the "Print 
Menus" program. For information on this subject, see the UNIFY 
Reference Manual, Section 3.2.2. 
The "Register Screen Form with ENTER" screen form has the 
following column headings. 
CD 
SCREEN NAME. This is the name of the screen form you 
want to register. 
o 
TARGET RECORD. This is the name of the record type that 
the screen form maintains. You must specify the target record 
type because fields from qifferent types may be present on the 
screen form. 
o 
HEADING. This is a 34 character string that displays on line 2 
when ENTER is' running. The heading also displays on each 
menu where this ENTER screen is a selection option. 


@) 
FORMATTING PROGRAMS. The area below this prompt is 
for updating and displaying the report generating processes 
associated with this ENTER screen. The combination of the 
formatting program name, parameters, title, and output options 
is called a report. 


® 
NAME. This is the first prompt of the update area. It is an 
eight character name for the executable formatting program 
that is run to produce the report. A maximum of eight 
different formatting programs can be associated with each 
ENTER screen. 
For "Register S.creen Form with ENTER," the formatting 
program can be the listing processor (LST), report processor 
(RPT), a user supplied non-UNIFY executable, or a blank. 
(LST and RPT must be in upper case letters.) A formatting 
program that you supply is a "custom program." For 
information on the Listing Processor, see the UNIFY Reference 
Manual, Section 8. 
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® 


® 
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UNIFY executable names other than RPT or LST are not 
accepted. When you enter a blank, no formatting program is 
used and the report lists the fields on the screen form in a 
simple, tabular format. If the length of all the fields exceeds 
80 characters, this type of report will simply wrap the extra 
characters onto the next line. 
The NAME field is edited so only the characters before a blank 
remain. When you press IRETURN!, the string is left justified. 
Leading spaces and extra characters are also deleted. 


PARAMETERS. This field allows you to enter four, 14 
character strings that are passed as parameters to the 
formatting program. The formatting program must interpret 
the meaning of the parameters. You enter parameters vertically 
adjacent to each hyphen (-). The type of formatting program 
determines the number of parameters. 


Formatting 
Maximum Number 
Program 
of Parameter Fields 
RPT 
1 (the name of an RPT script) 
LST 
1 (the name of an LST script) 
blank 
0 
custom program 
4 


A PARAMETERS entry must l::ie one word without embedded 
or leading spaces. However, when NAME is a custom program, 
the parameters are not edited. You can place more than one 
parameter in each PARAMETERS field by leaving spaces, 
providing the total length does not exceed 14 characters. 


TITLE. This is a descriptive label for the report. This field 
displays on the Report Options Screen to identify the report. 


OUTPUT. This sets the allowed destinations for report output 
and the optional "debugging" mode. You can route output to 
more than one destination per run. The four accepted 
characters are as follows. 


CHARACTER 
DESCRIPTION 
S 
enables the screen output option 
(DEFAULT) 
P 
enables the printer output option 
F 
enables the file output option 
N 
disables the debug option, no- 
debug (enable, DEFAULT) 


( 
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The program accepts lower case entries and then converts them 
to upper case. Duplicate entries are ignored. 
Debug mode displays error messages, the report script, and run 
time results. If debug mode is enabled, then at run time you 
can verify the actual script, and see any syntax errors so you 
can correct the script. 


® 
CM:D 
. The remainder of the screen is the display 
area. The first line of each report displays here in the order the 
report will appear on the ENTER Report Options Screen. 
Reports are added and modified in the update area, but they 
are deleted directly from this area. You enter the control 
commands for each line under CM:D. 


Those commands are as follows. 


WHEN you want to... 
THEN enter... 
stop entering reports 
q (quit). 
and leave the display 


w 


area 
delete the current report 
d (delete) 
add·a report 
a (add). You can only enter this on a 
blank line. 
move the current report 
a number from 1 to x, where x is the 
to another line position 
number of reports registered with this 
screen. All rep,?rts are renumbered 
after the move. 
modify fields associated 
m (modify) 
with the current report 


'When you change NAME to blank, all the parameter fields are 
erased. When you change NAME to a UNIFY formatting 
program, all parameter fields except the first are erased. 


\.. 


( 


CJ 
STEP 24: 
Action: 


Eff~ct: 


Select modify mode. 
Enter an m at the operation prompt. 
The operation prompt at the bottom clears and the 
cursor moves to the SCREEN NAME prompt. 
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(entmnt] 
(M]ODIFY 


UIlIFY Rel..... 3.2 
Reqiat.r SCr••n Fbrm with ENTER 


10 
JAN 
1985 
- 
14: 22 


SCREEN NAME: 
it.m 
TARGET RECORD: it.m 
HEADING: Inv.ntory It.m Kaint.nanc. 


FORMATTING PROGRAMS: 
NAME 
PARAMETERS 


• 


TITLE 
OUTPUT 


S 


CMD 
_ 


a 
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o 
STEP 25: 


Action: 


Effect: 


o 
STEP 26: 


Action: 


Effect: 


Retrieve. the "Inventory Item Maintenance" 
ENTER screen data. 
Enter the item screen name. 
The system displays the Target Record and 
Heading data. 


Move to the hrst blank line in the display area. 
Select add mode. 
Press IRETURNI to move the cursor to the first 
line in the CMD column. 


Then enter an a. 
The system automatically sets the Output to S 
(screen). The cursor moves to the update area 
below NAME as shown. 


[.ntmntj 
[MjODIFY 
UHXFY R.l•••• 3.2 
R.qi.t.r Scr••n Fora vith Ell'I'ER 


Query By Forms 


10 JAM 19S5 _ 14, 22 


SCREEII' llAMB: 
it .. 
TARGET RECORD: it .. 
HEADXXG: 
IDY.n~ory 
I~.& Mainteaance 


FORMAT'l'IliG 
PROG1lAIIS: 
llAMB 
PARAMETERS 
iP'I' 
i~i.t.r 
'l'ITL& 
Curr.nt It.me R.port 
OU'l'PU'I' 


P 


CMD 
_ 
• 


D 
STEP 27: 
Register the name of this report's formatting 
program. 
Action: 
Enter RPT in the N,AME column. 


D 
STEP 28: 
Register the RPT report script for this report. 
Action: 
Enter the name of the script, itmllst.r, in the 


l.- 
PARAMETERS column. (You will create this 
script later.) 


D 
STEP 29: 
Title the report. 
Action: 
Enter the descriptive name for this report, Current 
Items Report, in the TITLE column. 


D 
STEP 30: 
Specify the valid output destination for this report. 
Action: 
Enter a P in the OUTPUT column. 
Reason: 
For this report, you're allowing output to the 
printer. You must allow at least one output 
destination for every report. 


D 
STEP 31: 
Return to the NAME column. 
Action: 
Press IRETURNI again. 


C 


( 
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(.ntmntl 
(M10DIFY 


TJNI:FY Releaa. 3.2 


R.qiat.r sere.,. Form with ENTER 


10 JAN 
1985 
_ 
14:22 


SCllEEN 
NAME: 
it.m 
TARGET RECORD: it.m 


FORMATTING PROGRAMS: 
NAME 
PARAMETERS 


• 


TITLE 
OUTPUT 


8 


ClID 
_ 


1 llM' 
itmliat.r 
Curre,.t :It.... lIaport 
P 
.. 


0 
STEP 32: 
Action: 


0 
STEP 33: 
Action: 
Reason: 


0 
STEP 34: 
Action: 


Move the new report definition to the display area. 


Press ICTRL! IDJ. 


Select add mode. 
Enter an a at the next blank CMD line. 
You're ready to add the second report for this 
ENTER screen. 


Add the second report. 
Enter the following information. Notice that we 
are allowing output to both the screen and the 
printer for this report. 


NAME 
RPT 
PARAMETERS 
orderlst.r 
TITLE 
Item Order Listing 
OUTPUT 
SP 
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o 
STEP 35: 
Action: 


Effect: 


Move the data to the display area. 


Press ICTRLI IDJ with the cursor in the NAME 
column. 
The following is what the display area looks like 
now: 


[entmnt] 
[M]OOIFY 
UKl:FY R.l.a•• 3.2 


R.qi.t.~ Sex••n 
Form with ENTER 


Query By Forms 


10 JAN 1985 _ 14:22 


SCREEH HAKE: 
1t.m 
TARGET RECORll: 
1t.m 
BJ:AJ)IHG: Inventory It..1IL Maintenance 


FORMAT'l'IHG PROGRAMS: 
HAKE 
PARAMETERS 
TULE 
OIl'l'PIl'l' 


CMO 
_ 


1 RPT 
1tm11at.r 
Curr.nt It.... R.port 
P 


2 RP'l' 
orcS.rlat. r 
It... orcS.r L1.t1n'i 
SP 
• 


D 
STEP 36: 
Return the cursor to the TARGET RECORD 
prompt. 
Action: 
Enter a q at a CMD line. 


D 
STEP 37: 
Exit "Register Screen Form with ENTER" and 
return to the "UNIFY Main Menu." 
Action: 
Press ICTRL/ IDl three times. 


D 
STEP 38: 
Select the UNIFY "Edit SQL or RPT Command 
Files" program. 


( 
Action: 
Enter a 4 at the selection prompt. 


Note: 
For information on this, see Section 7. 


D 
STEP 39: 
Enter and save the first RPT report script, 
itmlist.r. 
Action: 
Enter the text as follows: 


\. 
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File: itmlist.r 


input 


item. Serial-NUmber , 


item.Manufacturer_I~, 
manf.Name, 
item•Model-NUmber , 


model.~escription, 


item.Ac~isition-Date, 
item.Salee-Price, 
item.Order-NUmber, 
item. Parch&.e-Price 


width 80 
sort Description, Serial-NUmbar 
header 
print 'DATE:' col 1, toc1ay, 
'PAGE:' col 68, pageno using "'1d' 


print 'TIME:' col 1, hour 
skip 2 
print 'c U R R E N TIT EMS 
LIS TIN G' centered 


skip 2 
print 'MODEL DESCRIP'l'ION' col 1, 
•Serial #' col 31 no newline 


print 'Manf #' col 42, 
'Model #' col 51 no newline 


print 'Acq Date' col 60 no newline 
print 'Price' col 72 
print 76[-1 
before Description 
print Description col 1 
detail 
print Serial-NUmber using '##1111111' col 30 no newline 
print Xanufacturer_I~ using '1111' col 44 no newline 
print Xodel-NUmber using '1111111' col 51 no newline 
print 
Ac~isition-Date col 60 no newline 
print Parch&se-Price using 'II.&'&" 
col 72 


after Description 
skip 


end 


This script produces a report similar to the following. 
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DATE: 06/28/84 
PAGE: 
1 


TIME: 
11: 18 


C 1)' R R E N T 
I T EMS 
LIS TIN G 


( 
MODEL DESCRIPTION 
Serial # 
Manf# 
Model # 
Acq Date 
Price 
,. 
---------------------------------------------------------------------------- 
1/2' , socket wrench 
1001 
100 
1001 
02/15/84 
7.25 
1002 
100 
1001 
02/15/84 
7.35 
1003 
100 
1001 
02/15/84 
7.25 
1004 
101 
55071 
02/23/84 
8.90 
1005 
101 
55071 
02/25/84 
9.25 


1013 
104 
1012 
02/08/84 
9.23 


3' • Phillips screwdriver 


1008 
103 
61117 
01/15/84 
2.20 


1009 
103 
61117 
02/15/84 
2.00 


3/4' , socket wrench 
1014 
100 
1002 
02/23/84 
13.23 


6' , slotted screwdriver 
1010 
103 
91117 
01/15/84 
3.00 
1011 
103 
91117 
02/15/84 
2.20 


combination pliers 
1006 
101 
55271 
02/15/84 
6.00 
1012 
104 
1011 
02/08/84 
5.75 


leather mallet 
1007 
102 
1002 
01/19/84 
5.25 


[J 
STEP 40: 


Action: 


Enter and save the second RPT report script, 
orderlst.r. 


Enter the text as follows: 
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File: orderlat.r 


input 


item.Serial-Namber, 
item.Manufacturer_ZD, 
manf.Name, 
item.Model-NUmber, 
model. Description, 
item.AcquisitiOD-Date, 
item.Sales-Price, 
item. Order-NUmber , 
item. Purchase-Price 


width 80 
sort Ordsr-NUmber, Serial_NUmber 
header 


print 'DATE:' col 1, today, 
'PAGE:' col 68, pageno using '''ld' 
print 'T:IME:' col 1, hour 
skip 2 
print 'I T E H 
0 R D E R 
LIS TIN G' centered 
skip 2 


before Order-NUmber 
print 76[-1 
print 'ORDER I.' col 1, Order-NUmber using 'III' no newline 
print 'Serial I' col 30, 'Description' col 4S 
print 8[-1 col 30, 11[-1 col 4S 
deta:1l 
print Serial-Namber using '111111111' col 29 no newline 
print Description col 4S 


after Order-NUmber 


skip 2 


end 


This script produces a report similar to the following. 
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DATE: 06/28/84 
TIME: 
11:19 


Query By Forms 


PAGE: 
1 


1 T E M 0 R D E R 
LIS TIN G 


ORDER # 


ORDER # 
2 


ORDER # 
3 


Serial # 


1001 
1003 
1004 
1006 
1007 
1010 
1011 
1012 


Serial # 


1008 
1009 
1013 
1014 


Serial # 


1002 
1005 


Description 


1/2" 
socket wrench 


1/2" 
socket wrench 


1/2" 
socket wrench 
combination pliers 
leather mallet 
6" 
slotted screwdriver 
6" 
slotted screwdriver 


combination pliers 


Description 


3" 
Phillips scrswdriver 
3" 
Phillips screwdriver 
1/2" 
socket wrench 
3/4" 
socket wrench 


Description 


1/2" 
socket wrench 


1/2" 
socket wrench 


o 
STEP 41: 


Action: 


Return to the "UNIFY Main Menu." 


Quit the editor when you complete entering the 
scripts. 


9.3 USING THE ENTER REPORT OPTIONS SCREEN 


Now that you have registered two reports with the "Inventory Item 
Maintenance" ENTER screen, you can perform a query and generate 
the new reports. 


o 
STEP 42: 


Action: 


Select "Inventory Item Maintenance." 


Enter item at the selection prompt as shown. 
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Effect: 
The following screen form displays. 


(item] 


Serial Number 
Manufacturer ID : 
Mod.el Numb.r 


Acquiaition Date: 
Sale. Price 


Order Number 


Purcha•• Price 


UHIFY a.l•••• 3.2 
Inventory Ite. Maintenance 


10 JAlf 1985 _ 14:22 


j 


(IjNQUIRE. 
(A]llll. 
(M]OIlIFY. 
[1l]ELE'I'E;1- 
J 


"'----------------------~../ 
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o 
STEP 43: 
Action: 
o 
STEP 44: 


Action: 
Effect: 


Select inquire mode. 


Enter an i as shown. 


Sele"t all item rec.ords. 
Press ICTRLI mJ. 
The first record displays on the screen as follows. 


[iteml 
[IlNQl1UlE 


Serial Number 
1001 


Manufacturer 10 
100 


Model Number 
1001 


Acqui.ition Date: 
02/15/84 


Sale. Price 
10.24 


Order Number 
: 
1 


PurchA.e Price 
7.25 


11NIFY Rele••e 3.2 


Inventory Item 
K&in~.nanc. 


RH Smith M.nufacturinq 
1/2- eocket wrench 


Query By Forms 


10 JAN 1985 _ 14:22 


[NlEXT. 
[PlREVIOl1S. 
[MlODIFY. 
[SlTOP r- 


"-.••a.rched: 
14 selected.: 
1. current: 


(- 


o 
STEP 45: 


Action: 


Effect: 


Note: 


Display the "Report Option Screen." 


Enter an r (Report) as shown. 
The Report Options Screen displays. 


This screen lists all the reports for this ENTER 
screen. 
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[itom] 
[I]NQUlRE 


UNIFY Release 3.2 


L~ventory Item Maintenance 


10, JAN 
1985 
_" 
14: 22 


REPORT 


1. 
Cuz'rent I:t.ema B.eport 


TO: 
SCREEN 
PRINT 
FILE 
FILENAME 


[ 
] 


2" 
Itom Ordor Listing 


REPORT 
#: 
1_ 


[ 
] 
[ 
] 


o 
STEP 46: 


Action: 
Effect: 
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Select the "Current Items Report." 


Enter a 1 at the REPORT #: prompt as shown. 


The system highlights and sets output to go to the 
printer, because this is the only valid destination. 


The "Proceed" prompt displays at the bottom of 
the screen as follows. 


[item] 
[I1NQUIlU: 


lU:POR'1' 


Query By Forms 


UIlIFY Rehe.e 3.2 
10 JAJf 1985 _ 14:22 
IDVentory It•• Maintenance 


'1'0: 
SClU::EN 
PUN'1' 
FILE FIL:ENAME 


2. Item Order Liatinq 
[ 1 
[ 
1 


\. 


R:EPOR'1' I: 
1 Proceed in [Ploreqround. 
[B]&ckqround. 
[Dlebuq or 
[~.nc.l? 8 


The prompt: 


Proceed in [F]oreground, [B]ackground, [D]ebug or [C]ancel? 


allows you to control the method of running the report. 


The [D] ebug option does not display when you set the nodebug mode 
(N) with "ENTER Screen Registration." When you choose the 
SCREEN as an output destination, ENTER does not allow the 
[B]ackground option. The possible selections are as follows. 


WHEN you want to... 
THEN select... 
run the report while you wait 
f (foreground) 
run the report and continue working 
b (background) 
run the report in the foreground, and display 
d (debug) 
the scripts, run time results, and error 
messages 
cancel the report request and return to 
c (cancel) 
REPORT #: 
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[item] 
[I]NQUlRE 
UNIFY Roluao 3.2 
Inventory Item MAintenance 


10 JAN 
1985 
_ 
14: 22 


REPORT 
TO: 
SCREEN 
PRINT 
FILE 
FILENAME 


2. 
Item ordor Liatinq 
[ 
] 
[ 
] 


REPORT ,: 
1 
Procoad in [Floraqround. 
[B]ockqround. 
[D]obuq or [Cloncd? b- 
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o 
STEP 47: 


Action: 
Effect: 


o 
STEP 4~: 


Action: 
Effect: 


Run the report in background mode. 


Enter a b (background) as shown. 


Messages appear at the bottom of the screen when 
the report has started. 


The report runs in the background and 
subsequently prints out on your printer. 


Continue working. 


Press IRETURNI. 
The ENTER Report Options Screen clears and 
redisplays. 


(ito..] 
(I]HQUIRS 


RSPORT 


Query By Forms 


UNIFY R.l.... 3.2 
10 JAlf 1985 - 
14:22 
Inv.ntory It... Maint.nanc. 


'1'0 : 
SCRSEN 
PRINT 
FILl FILEIlAMlI: 


l 


1. Cuzr.nt It.... R.port 
[ 
] 


REPORT ,: 
2 Proc••d in 
[Flo~9%ound. (Dl.buq or [Clanc.l? f. 


D' 
STEP 49: 
Select the "Item Order Listing." 


Action: 
Enter a 2 at the Report #: prompt. 


0 
STEP 50: 
Select the screen output option. 


Action: 
Enter an x in the SCREEN column and press 
IRETURNI. 


0 
STEP 51: 
Select the printer output option for the same run. 


Action: 
Enter an x in the PRINT column and press 
IRETURNI. 


0 
STEP 52: 
Finish the output selection. 


Action: 
Press ICTRLI IQ] with the cursor positioned in the 
SCREEN column. 


Effect: 
The cursor moves to the "Proceed" prompL 


0 
STEP 53: 
Run the report while you wait. 


Action: 
Enter an f for foreground mode processing. 
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Effect: 


Note: 


o 
STEP 54: 


Action: 


Effect: 


There is a delay while the report runs. 


Since the report fills more than one screen, you 
can page through it by pressing IRETURNI when 
the "Display next page?" prompt appears. 


Continue working after completing the report. 
When the report completes, the following prompt 
displays. 


Complete. Please enter RETURN to continue. 


Press IRETURNI. 
The ENTER Report Options Screen displays. 


(it...] 
(I]NQUIRE 
UXIFY R.l•••• 3.2 


Inv.ntory Item Maintenance 


10 JAN 1985 _ 1.:22 


REPORT . 


1. Current Itema aeport 


'1'0: 
SCREEN 
PRINT 
FILE FILEIlAl!E 


( 
] 


2. It... Ord.r Li.tinq 


REPORT #: .dit itmli.t.r 


( 1 
( 1 


o 
STEP 5$: 


Action: 
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Modify the RPT script, itmlist.r, at the 
REPORT If: prompt. 


Enter the edit keyword and the itmlist.r script 
name as shown. 


Reason: 


Effect: 


o 
STEP 56: 


Action: 


inpa.t 


Query By Forms 


This shows how you can interactively develop 
reports by editing and running them, all from the 
same screen. 


ENTER starts up the text editor. 


Remove the commands that generate the 
acquisition date column in the report. 


Delete the two lines highlighted: 


item.Serial-Number, 
item.Manufacturer_X» , 
manf.N_e, 
item.Xo4el-Number, 
model. Deecription, 
item.AcquieitiOU-Date, 
item.Salee-Price, 
item. Order-NUmDer , 
item.Purchaee-Price 
width 80 
sort Description, Serial-Number 
hsadsr 


print 'DATE:' col 1, today, 
'PAGE:' col 68, pageno using '''1<1' 
print 'T:IME:' col 1, hour 
skip 2 
print 'c U R R E N TIT EMS 
LIS TIN G' centered 
skip 2 
print 'MODEL DESCRIPTION' col 1, 'Serial #' col 31 no newline 
print 'Manf #' col 42, 
'X04el #' col 51 no newline 
!~_]1~~••"'11:!'1f. 
print 
Price 
col 72 
print 76[-1 
before Deecription 


print Deecription col 
1 
dstail 


print Serial-Number using '#########' col 30 no newline 
print Manufacturer-I» using '####' col 44 no newline 
print Xo4el-Number using '#######' col 51 no newline 
I 
11" JiCtRU[]'_Jltr..r'nHtW 
print Purchase-Price using 
##.&& 
col 72 


after Description 


skip 
and 


o 
STEP 57: 


Action: 
o 
STEP 58: 


Action: 


Return to the ENTER Report Options Screen. 


Quit the editor. 


Rerun the "Current Item Report." 


Enter a 1 again and review the change. 
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0 
STEP 59: 


Action: 


Effect: 


0 
STEP 60: 


Action: 


UNIFY Tutorial 


Return to the "Inventory Item Maintenance" 
screen. 


Press ICTRL! IQJ at the REPORT #: prompt when 
you're through with the Report Options Screen. 


The ENTER screen redisplays. 


Return to the "UNIFY Main Menu." 


Press ICTRLI IKl to return to the active menu and 
ICTRLI IKl one more time to get back to the main 
menu. 
Now you have seen some of the capabilities of ENTER Query by 
Forms, and how easy it is to use ENTER screens to select records for 
reports. You have also seen how UNIFY makes it convenient for you 
to develop reports interactively. by successively editing the script and 
running the report, all from the ENTER Report Options screen. 
In the next section, you will see how to use screen forms in 
conjunction with SQL and RPT to build simple to use reports with 
even more selection power than is available with ENTER. 
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Section 10 
Using SQL By Forms 


10. Using SQL By Forms 
10.1 Defining the Report 
10-3 
10.2 Building the Screen Form 
10-9 
10.3 Registering the Screen Form with SQL 
10-11 
10.4 Using the SQL Screen 
10-18 


10. USING SQL BY FORMS 


In an application system, you generate reports regularly. While the 
format of the reports remains relatively constant, the data you want 
to use changes all the time. 
Suppose, for example, you want a report with certain Zip codes, the 
current accounting period, or specific customers. Each of these 
subjects can be the basis of a report. But the next time you generate 
the report, you want different Zip codes, a different accounting 
period, different customers. 
This section shows you how to use SQL, RPT, and screen forms to 
build easy to use reports that can handle just about any situation like 
this. 
SQL by Forms consists of two parts. The first, "Register Screen 
Form with SQL," lets you specify what screen form to associate with 
a particular SQL query and set of report scripts, and where you want 
to send the output of the report. The registration process creates an· 
entry in the data dictionary called an SQL screen. You can then 
place SQL screens on menus the same way as executables and 
ENTER screens. 
The second part, the SQL screen driver, displays the screen form and 
allows you to enter data values for each screen field. Once you 
indicate the values are acceptable, the screen driver calls the SQL 
Report Options Screen to let you specify several options. 
These are: 
• 
where to send the output of the report 
• 
whether to run the report in background or foreground 
• 
whether to display the SQL and report scripts or not 
Parameters 
The purpose of an SQL screen is to let you specify, by using a screen 
form, values to be substituted into SQL and RPT scripts. So, you 
need some way to indicate in query and report scripts where to sub- 
stitute the values. The way to accomplish this is to place parameters 
into the scripts. The SQL screen driver can then recognize the 
parameters and substitute the real values before running the scripts. 


lJ NlfoY Tutorial 


A parameter is simply a "place holder." It has the form $n, where n 
is a number from one through the number of parameters you want to 
supply. 


You can position parameters throughout the text of SQL and RPT 
scripts. The scripts go into ASCII text files, which are then 
registered with a screen form. The s~reen form should have the 
same number of screen fields as there are distinct parameters. 


For example, the value you enter in the first screen field substitutes 
for $1, the value you enter in the second screen field substitutes for 
$2, and so on. 
You generally place parameters in the SQL where and having clauses. 
For example, to select records based on a date range, you would use 
a where clause similar to the following. 


where Hire...J>ate between $1 and $2 


Or, to select departments with an average salary greater than a 
value, you can use a having clause similar to the following. 


having avg(Salary) > $1 


Matching Parameters 
The number of parameters you use depends only on the report 
requirements. However, as mentioned before, the number of 
parameters you use in the SQL script must equal the number of 
screen fields on the screen form. 
Otherwise, the screen driver does 
not know how to process the values. 
For example, when there are three screen fields on a form and two 
parameters in the script, the screen driver can ignore the extra value. 
It is probable, however, that either the screen form or the script 
design'is incorrect. 
Conversely, when there is one screen field and there is no value to 
enter for the second parameter, a syntax error will occur when SQL 
processes the script. 
For these reasons, the screen driver reports an error when the 
number of screen fields on the form does not match the number of 
parameters in the SQL script. 
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Using String Parameters 


The SQL screen driver substitutes parameters in scripts just as you 
enter them. So when you want to use a string parameter, you must 
enclose the parameter with single quotes. 


Suppose, for example, you want to select records based on 
State-Code, a STRING field of length two. The where clause 
fragment would be as follows. 


where State-Code'" '$1' .•• 
If you omit the single quotes, a syntax error will occur when SQL 
processes the script. 


10.1 DEFINING THE REPORT 


The report you will develop in this section is similar to the report in 
Section 8. The only difference is that you will be adding two 
parameters to allow.selection based on a date range. 


The following is an example of the new Purchase Acquisitions report. 
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PURCHASE ACQUISITIONS 


Acqnisition Period: 01/15/84 to 02/15/84 


Item Description 


1/2" socket wrench 


Acqnisition 


Date 


02/08/84 
02/15/84 
02/15/84 


Purchase 


Price 


9.23 
7.25 
7.35 


Numl:>er 


of Items 


1 
2 
1 


Total 
4 


3" Phillips screwdriver 


01/15/84 
2.20 
02/15/84 
2.00 


Total 
2 


6" slotted screwdriver 


01/15/84 
3.00 


02/15/84 
2.20 


Total 
2 


combination plisrs 


02/08/84 
5.75 


02/15/84 
6.00 


Total 
2 


leather mallet 
01/19/84 
5.25 


Total 


Total Purchases 
11 


This report uses the SQL script, acqIist.s, to select the data for the 
report. It also uses the RPT script, acqIist.r, to format the SQL· 
output as a structured report. 


Begin the development of the report by creating the SQL script, 
acqIist.s, and the RPT script, acqIist.r. 
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;rmainmenu] 
UNIFY Relea•• 3.2 
UNIFY Main Menu 


SQL By Forms - 


10 JAlf 1985 _ 14:22 '\ 


SELECTION: 4- 


2. Create or Modify Screen Forme 


3. 
SQL - 
Query/1lMt. L&nqueqe 


4. B4it SQL or RP'l' Comman4 Pile. 


5. Ad4. Modify or Delete Menu- 


6. Data Baae D••iqu Utilitie. 


8. Data Bntry Scre.ne 


( 


\. 


o 
STEP 
1: 


Action: 


Effect: 


Reason: 


Select the "Edit SQL or RPT Command Files" 
(edit) option. 


Enter a 4 at the selection prompt. 


UNIFY then starts the current text editor without 
a file name. 


You want to create the new scripts. 
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0 
STEP 
2: 


Action: 


Reason: 


0 
STEP 
3: 


Action: 


UNIFY Tutorial 


:r purchase. 8_ 


Create the new SQL script, acqlist.s. 


Read in the purchase.s file as shown. 


You want to make a copy of the file purchase.s 
and call it acqlist.s. 


Modify the script. 


Add the new SQL line (highlighted in bold) as 
follows: 


File: acqlist.s 


lines 0 
select Description. Acquisition-Date. Purchase_Price. count(·) 
from item. model 
where model.Model_Number • item.Model_Number and 


model.Manufacturer_ID • item.Manufacturer_ID 
rdllI::t:rll&:.t••&I:iJlwJl'iiill. 


group by Description. Acquisition-Date. Purchase-Price / 
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Note: 


o 
STEP 
4: 


Action: 


:r purchase.x- 


o 
STEP 
5: 
Action: 


o 
STEP 
6: 


Action: 


SQL By Forms 


The values from the SQL screen will replace the 
two parameters, $1 and $2. 


Save the file. 
Perform the steps necessary to save the file under 
the name acqIist.s. 


Create the new RPT script acqIist.r. 
Read in the file purchase.r as shown. 


Modify the file. 
Add the new lines (highlighted in bold) as follows: 


10-7 


UNIfY Tutorial 


File: acqlist.r 


inpllt 


model.Description, 
item.Acquisition_Date , 
item. Purchase_Price , 
item_count [numeric 2J 


sort Description, Acquisition_Date 
width 80 
header 


print 'PURCHASE ACClO'XS:ITXONS' centered 
skip 


print 
Item Description', 'Acquisition' in col 30 no newline 
print 'Purchase' in col 47 , 
'Number' in col 61 


print 'Date' col 33, 'Price' col 48, 'of Items' col 60 
print 70[-J 
before Description 
print Description 


detail 


print Acquisition_Date in col 31 no newline 
print Purchase_Price in col 47 using '11.&&' no newline 
print item_count in col 63 using 'I&" 


after Description 


print '--' col 63 
print 'Total' col 55, total(itel\l_count) col 63 using 'I&.' 
print 70[-J 
aftsr report 


print 
col 62 
print 'Total Purchases' col 45, total(item_count) col 62 using 'II&.' 


end 
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o 
STEP 
7: 
Action: 


o 
STEP 
8: 


Action: 
Reason: 
Effect: 


Save the file. 
Perform the steps necessary to save the file under 
the name acqlist.r. 


Return to the main menu. 
Quit the edhor. 


You're ready to build a screen form. 
The "UNIFY Main Menu"·redisplays. 


SQL By Forms 


10.2 BUILDING THE SCREEN FORM 


You're now ready to create the screen form, acqIist, that prompts for 
the values the SQL script requires. 
The following is an example of the "Acquisition Period" screen form. 


C"cq11·~1 
UNIFY Rele••e 3.2 


Ac~.1~1on Per104 


1 0 J JUl 1985 _ 1 4: 22 


STARTING ACQUISITION DATZ: 1/15/84 


ENDING ACQUISITION DATZ: 
2/15/84 


A_c_ce_p_~_e_n~_r_1_ 
••_CC_T_lIL_E_l_'_C_le_&_r_f_1_el_4_CC_T_lIL-:-Z_l,_Exi._~_C_C_TlIL_X_l 
j 


Use paint to create this screen form.- 


10-9 


UNIFY Tlltorial 


rnainmenu] 
OXIFY a.l•••• 3.% 
OXIFY M.1n M.nu 


1. 
D••iqn and Cr.ate a X.w 
D&~a a••• 


%. Cr••~. or M041fy Scr..... 


5. A44. M041fy or 
D.l.~. M.nua 


6. 
D.~ a.a. D.a1qu 
U~1l1t1.a 


1. Syat•• A4a1n1atr.t1on 


8. Dat. Entry Scr..... 


. [J 
STEP 
9: 
Action: 
Reason: 


Effect: 


[J 
STEP 10: 


Action: 


Effect: 


10-10 


Select t4e "Paint Screen Forms" (paint) option. 
Enter paint as shown. 
You're ready to design the screen form. For 
information on "Paint Screen Forms," see Section 
5.l. 
The PAINT operation prompt displays. 


Prepare to enter the new screen form. 
Select add mode and enter the screen form name, 
acqUst 
The screen clears to start the session. 


[paint] 
COll\lll&ncl Mocl. 
• 


UNIFY a.l•••• 3.2 


Paint Screen Forma 


SQL By Forms 


10 JAN 1985 - 
14:22 


F: 
L: 
2 C: 
0 


STARTIHG ACQUISITION OATS: 
l 
_ 


ENDING ACQUXSITION DATS: 
Z _ 


0 
STEP 11: 
Create the screen form design. 


Action: 
Enter the information by field number as follows: 


Field 
Screen 
Data Base 
Number 
Field: 
Field: 
Type: 
Length: 
I 
sstart 
blank 
DATE 
default 
2 
send 
blank 
DATE 
default 


Note: 
You don't need .0 enter values for the Data Base 
Field because there are no corresponding data base 
fields. 


The Length field doesn't ne~d a value because 
DATE has a default length. 
Remember: 
The screen fields must be in the same order as 
their corresponding p.arameters in the SQL script. 


0 
STEP 12: 
Quit the editing session and save the screen form. 
Action: 
Perform the steps necessary to save the screen 
form and exit PAINT. 
Effect: 
The main menu displays. 


10.3 REGISTERING THE SCREEN FORM WITH SQL 


You're now ready to register the screen form using "Register Screen 
Form with SQL." This process tells the SQL screen driver what 
screen form to display, and what SQL and RPT scripts to use. 
This option also allows you to title the reports, and specify the valid 
output options. The process is very similar to registering a screen 
form with ENTER. 
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o 
STEP 13: 


Action: 


o 
STEP 14: 


Action: 


Effect: 


Select the "Create or Modify Screen Forms" 
(screens) menu. 


Enter a 2. 


Select the "Register Screen Form with SQL" 
(ssqlmnt) option. 


Enter a 3. 


The following screen form displays. 


(ssqlmnt) 
UNIFY a.l•••• 
3.~ 


a.~i.t.r Ser••n Form witb SQL 


10 JAJ( 1985 _ 1 4,~~ 


_cr••u form data 


~ntry ar•• 


SCREEN NAlIE~ 
SQL SCRIPT" 
m;~Jllll 


CMD 
_ 


® 


r.port d.finition 


p&~in~ ern 


This program allows you to inquire, add, modify, and delete the 
registration between a .screen form and the SQL screen driver. 


There are two entry areas on this screen: the screen form data entry 
area and the report entry area. There is also a report definition 
paging area. 


The operation prompt: 


[I]NQUIRE, [A]DD, [M]ODIFY, [D]ELETE 


allows you to select an operation mode for the program. 
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WHEN you want to... 
THEN select... 
scan a screen form's registration data 
i (inquire) 
register screen· forms with the SQL screen 
a (add) 
driver 
modify the data for an existing SQL screen 
m (modify) 
delete an SQL screen 
d (delete) 


When you delete an SQL screen, the deletion does not affect the 
original screen form. It does, however, remove references, such 
as menu listings. 


For information on deleting screen forms, see Section 5.1. For 
information on obtaining menu listings, see the UNIFY 
Reference Manual, Section 2.2.2. 
The "Register Screen Form with SQL" screen has the following 
prompts and column headings. 
CD 
SCREEN NAME. This is the name of the screen form you 
. 
want to register. 
o 
SQL SCRIPT. This is the name of the file containing the SQL 
script to associate with the screen. 


eD 
HEADING. This is a 34 character string that displays on the 
second line when SQL by Forms is running, and on menus 
where this SQL screen is a selection option. 
o 
FORMATIING PROGRAMS. The area below this prompt is 
for updating and displaying the report generating processes 
associated with this SQL screen. The combination of the 
formatting program name, parameters, title, and output options 
is called a report. 


® 
NAME. This is the first prompt of the update area. It accepts 
an eight character name for the executable formatting program 
that is run to produce the output. A maximum of eight 
different formatting programs can be associated with each SQL 
screen. 
For "Register Screen Form with SQL," the formatting program 
can be the report processor (RPT), a non-UNIFY executable, or 
a blank. (RPT must be in upper case letters.) A formatting 
program that you supply is a "custom program." 
UNIFY executable names other than RPT are not accepted. If 
you enter a blank, no formatting program is used, and the 
report prints just as it comes from SQL. 
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The program edits the NAl\fE field to eliminate embedded 
blanks. When you press IRETURNI, the program deletes 
leading spaces and extra characters. 


® 
PARAMETERS. This allows you to enter four, 14 character 
strings that are passed as parameters to the formatting program. 
The formatting program interprets the meaning of the 
parameters. You enter parameters vertically adjacent to each 
hyphen (-). The type of formatting program determines the 
number of parameters. 


Formatting 
Maximum Number 
Program 
of Parameter Fields 
RPT 
1 (the name of an RPT script) 
blank 
0 
custom program 
4 


A PARAMETERS entry must be one word without embedded 
or leading spaces. However, when NAME is a custom program, 
the parameters are not edited. You can place more than one 
parameter in each PARAMETERS field by leaving spaces, 
providing the total length does not exceed 14 characters. 


CD 
TITLE. This is a descriptive label for the report. This field 
displays on the Report Options Screen to identify the report. 


® 
OUTPUT. This sets the allowed destinations for report output 
and the optional "debugging" mode. You can route output to 
more than one destination per run. The four accepted 
characters are as follows. 


CHARACTER 
DESCRIPTION 
S 
enables the screen output option 
(DEFAULT) 
P 
enables the printer output option 
F 
enables the file output option 
N 
disables the debug option, no- 
debug (enable, DEFAULT) 


The pfogram accepts lower case entries and then converts them 
to upper case. Duplicate entries are ignored. 
You can run the report in debug mode to display error 
messages, scripts used, and run time results. When you enable 
debug mode, you can verify the actual script. Also, syntax 
errors are displayed to help you correct errors in the script. 
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® 
OVID 
The remainder of the screen is the display 
area. The first line of each report displays here in the order 
the report will appear on the SQL Report Options Screen. 
Reports are added and modified in the update area, but they 
are deleted directly from this area. You enter the control 
commands for each line under Cl\1D. Those commands are as 
follows. 


WHEN you want to... 
THEN enter... 
leave the display area 
q (quit) 
delete the current report from this 
d (delete) 
SQL screen 
add a report to this SQL screen 
a (add) 
move a report to another position in 
the line number of the 
the display area 
new position. The 
number can range 
from one to x, where 
x is the number of 
reports registered with 
this screen. 
modify fields associated with the 
m (modify) 
current report 


When you change the NAME field to blanks, all the parameter 
fields are erased. When you change the NAME field to RPT I 
all parameter fields except the first are erased. 
o 
STEP 15: 


Action: 
Add an SQL screen. 


Enter an a at the operation prompt. 


[aaqlmnt] 
[A]DD 


SCREEN NAIIE: .cqli.t 
SQL SCUM: 
acqli.t .• 


uxxrr R.l•••• 3.2 


Raqi.t.r S""••,. Form vith SQL 


IlEA1lIlIG: Acqui.:l.t:l.o,. P.r:l.048 


'0 JItJI 1985 - 
, .:22 


rORIUIl'TIlIG PROGRAKS: 
IlAIIJ: 
PAllAIIlI'nRS 
OU'l'PU'l' 


CMD 
_ 
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o 
STEP 16: 
Action: 
Register acqIist. 
Complete the fields as shown. 


[aaqlmnt] 
[A]DD 


SCREEN NAME: .cqliat 
SaL SCRIPT: 
.cqliat.a 


UXlPT R.l•••• 
3.~ 
R.'1iata,. Ser.." 
Po,.,. vith SaL 


lIEADIIlG: Acquiaitio" P.,.i04 


10 JIo1If 19S5 _ 1 4:~~ 


FORllATTING PROGRAMS: 


NAME 
PAllAIIETSRS 
• 


TITLB 
OtlTPtIT 
• 


CM» 
_ 


• 


o 
STEP 17: 


Action: 


Effect: 


Reason: 


Move to the first blank CMD line in the display 
area. 
Press IRETURNI and then enter an a to add a 
report. 
The system automatically sets the Output to S 
(screen). 


The cursor moves to the update area below 
NAME. 
You want to add a report to this SQL screen. 


[aaqllllDt] 
[A]DD 


SCREEIl 
IlAMB~ acqliat 


SaL SCRlP'l': 
acqliat.a 


UXlPT a.l••a. 
3.~ 
R.'1iata,. Ser••" Po,.,. vith SaL 


BEADIIlC: Acquiaitio" • .,.i04 


10 JAN 1985 _ 
14:~~ 


FORllATTIIlG PROGRAMS: 
IWtZ 
PAllAMIlTZRS 
lU'T 
acqliat . ,. 
TI'l'IJl 
Purchaa. AcquiaitioD8 
OtlTPtIT 


apr 


CKD 
_ 
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o 
STEP 18: 


Actions: 


Effect: 


o 
STEP 19: 


Action: 


SQL By Forms 


Define the report. 
A. Enter RPT as the name. 
B. Enter acqIist.r as the p~rameter. 
C. Enter Purchase Acquisitions for the title. 
D. Enter SPF as valid output destinations. 
You add the report and allow its output to go to 
the screen, the printer, and an output file. 


Each time you run a report, you can choose more 
than one output destination by using a 
combination of valid destinations. 


End the report addition and move the new report 
definition to the display area below the line. 
Press ICTRLI TIJ] with the cursor in the NAME 
column. 


\ - 


[..qlmnt] 
[A]DD 


SCREEN HAME: .cqli.t 
SaL SCRIP'!': 
.cqli.t•• 


OWIrr ••1•••• 3.2 


R~i.t.r Scr••,. Para with SaL 


BEADING: Acquiaitio,. P.riod 


10 JAM 1985 - 
14:22 


FORllAffING PROGRAMS: 
HAME 
PARAMETERS 
TITLB 
OOTPU'1' 


CMD 
_ 


q..n 
.cqli.t.r 
Purcha•• Acqui.itiODA 
SPP 


l 


o 
STEP 20: 
Action: 


Reason: 


Return to the menu. 
Enter a q to end the report add mode. 


Then press ICTRLI .!III several times to exit this 
option and return to the "Create or Modify Screen 
Forms" menu. 
You're ready to use the SQL screen. 
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10.4 USING THE SQL SCREEN 


[screens] 
11 HIFT 11. d •••• 3 . ~ 
Cr·••t:..o r Modify S cr••n P o:ma 


1. P .int S cr••n P orma 


1 0 J AM 1 985 _ 1 ,: ~~ 


~. 11. .qi.ter S cr••n P orm v ith E llTEII. 


5. D iapl.y 1. iat 0 f S cr.e,.. 


6.1" ••t. S cr••fta 


7. C OIIlpile S creene 


8. 11. ••tore Screen t 
0 D .t. D ictionery 


9. C reat.. D _fault. S cr••n F ora 


SELECTION: ,,,cqli.t- 
"' 
.. ..",...:I.t\C':"" 
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o 
STEP 21: 


Action: 


Effect: 


Select the new SQL screen, acqIist. 


Enter the screen name at the selection prompt as 
shown. 


The "Acq:uisition Period" screen form displays. 


The default values of the dates are asterisks. 


(&cqliatl 
llHIFY Rel•••• 3.2 
Acquiaition P.riod 


SQL By Forms 


10 JAN 1985 - 
14,22 


STARTING ACQUISITION OATS: 2/1/84 


ElIDING ACQUISITION DATS: 
2/15/84 


Accept .ntri•• [CTRL Sl. Cl••r fi.ld [CTRL Zl. Exit [CTRL Xl 


o 
STEP 22: 
Action: 
Effect: 
o 
STEP 23: 


C 
Action: 


Effect: 


Set the parameter values for the SQ]... script. 


Enter the dates as shown, then press IRETURNI. 
The cursor returns to the first prompt. 


Command the program to accept the parameter 
entries. 


Press ICTRLI m:J. 
The SQL Report Options Screen displays. 
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[4eqlielo] 
UNXFY 
a.~•••• 3.2 


Ae~eiloion P.~i04 


10 JAB 1985 - 
14:22 


REPORT 
TO : 
SCDEII 
PUlIT 
PILE PILEIlAlU 


1. 
Purchase Acquiaitiona 


REPORT ,: 8 


[ 
] 
[ 
] 
[ 
]-- 


o 
STEP 24: 
Action: 
Effect: 


Select "Purchase Acquisitions." 
Press IRETURN! at the REPORT H: prompt. 
The system highlights line 1 and the cursor moves 
to the SCREEN column. 


[4eqliet] 
UKIPT a.l•••• 3.2 
Aequi8ition P.~i04 


10 JAB 1985 _ 14:22 


REPORT 
TO: 
SCRESII 
PUlIT 
PILS PILZIlAlU 
1."'.· 
_n!I~~li 
Pi III 
[x] 
[xl 
[ ]-- 


REPORT': 
1 Proe••d in [Plor.gTound. 
[D].bu~ or [Clene.l? 8 
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o 
STEP 25: 


Action: 


Effect: 


SQL By Forms 


Send the outp'ut to the screen and printer at the 
same time. 


Enter an x in both the SCREEN and PRINT 
columns. 


Then press IRETURNI to move back to the 
SCREEN column and press ICTRLI IDJ. 


The "Proceed" prompt displays at the bottom of 
the screen. 


l 


!'-. 


The prompt: 


Proceed in [F]oreground, [B]ackground, [D]ebug or [C]ancel? 


allows you to control the method of processing the report. 
The debug option will not appear if you set the nodebug mode (N) 
for OUTPUT. When you choose the SCREEN as an output 
destination, SQL does not allow the background option. The possible 
selections are as follows. 


WHEN you want to... 
THEN select... 
run the report while you wait 
r (foreground) 
run the report and continue working 
b (background) 
run the report in foreground mode, and display 
d (debug) 
the scripts, run time results, and error 
messages. This mode is useful because it 
displays the scripts with the real parameter 
values in place. 
cancel the report request and return to 
c (cancel) 
REPORT #: 


10-21 


UNIFY Tutorial 


racqUet] 
llIlIFY bl.... 3.2 
Acqui.ition Period 


10 
JAJ( 
1985 
_ 
14: 22 


REPORT 
'1'0: 
SCREEH 
PRIHT 
FILE FILENAME 


[x] 
[ l-- 


REPORT 
#: 
1 Proceed in [F]oreqround. 
[D].buq or [C]anc.l? 
~ 
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D 
STEP 26: 


Action: 


Effect: 


Run the report in foreground mode. 


Enter an f. 


After a delay, the report runs and the following 
prompt displays at the end of the first page. 


Display next page? 


Co.eqli.tl 
UKIFY R.l•••• 3.2 
Aequi.itiou P.riod 


PURCHA9B ACQUXSITIOHS 


Aequi.itiou P.riod: 02/01/84 to 02/15/94 


SQL By Forms 


10 JAM 1985 _ 14:22 


Item D••cription 


1/2" 
aockat wrench 


Aequi.itiou 


D.t. 


02/08/84 
02/15/84 
02/15/84 


Purcha•• 
Prie. 


9.23 
7.25 
7.35 


HWlll:>.r 


of IU_ 


1 
2 
1 


Tot.l 
4 


o 
STEP 27: 


Action: 


Page through the report. 


Press IRETURN! after each next page prompt. 


When the report'completes, the following prompt 
displays. 


Complete. Please enter RETURN to continue. 
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[..cqU.t) 


3" Phillip••crewdriv.r 


6- slotted acrewdriver 


coMbination pli.r. 


OIfU'Y RAIl.... 3.2 
Acqui.ition P.ri04 


02/15/84 
2.00 


'rot..l 


02/15/84 
2.20 


'rot..l 


02/08/84 
5.75 


02/15/84 
6.00 


'rotal 
2 


10 JAM 
1985 _ 
14: 22 


0 
STEP 28: 
Respond to the prompt to continue working. 
Action: 
Press IRETURNI. 
Effect: 
The SQL Report Options Screen redisplays. 


0 
STEP 29: 
Exit the SQL Report Options Screen. 


Action: 
Press ICTRU ill]. 


0 
STEP 30: 
Exit the "Acquisition Period" screen form. 
Action: 
Press ICTRU 00. 


Effect: 
You return to the Menu Handler. 


0 
STEP 31: 
Return to the main menu. 
Action: 
Press the home command key. 
Effect: 
The UNIFY Main Menu displays. 
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Section 11 
Creating Help Documentation 


11. CREATING HELP DOCUMENTATION 


UNIFY provides comprehensive help documentation for all menu 
options in the standard release. 


However, the options you have added to the menu system so far don't 
have any help documentation yet. 


This section shows you how to enter help information for the 
"Inventory Item Overview" report, using "Create or Modify Help 
Documentation." 


S&L&C'l'ION: ,. 


UKIFY aelaaee 3.2 
UKIFY Ma1n Menu 


1. D••1qn and Cr.ate & Hev Data B••• 


3. 
SQI. - Query/llML Lanqu&qe 


•• E41t SQI. 
O~ RPr Comman4 P1laa 


5. Ad4. Mo41fy 
o~ Delate Manue 


6. Data'Ba.e De.19'" Uti11t1a. 


,. Sy.tea Adm1n1auat1on 


8. Data Entry Scree... 


10 JAlIl 1985 - 
1"22 ....... 


o 
STEP 
1: 


Action: 


Effect: 


Select the "System Administration" (sysadmin) 
menu. 


Enter a 7 as shown. 


The menu displays as follows. 


UNIfY Tutorial 


[ayaadminJ 
1lIlIPY !Wha.. 3.3 


Sy.~•• 
A4&1ni.~ra~ion 


3. 
Da~a Ba•• 
Main~ananc. 


3. 
sacuri~y Main~ananca 


4. 
craa~. 
ClI< M<>4Uy H.lp 
Iloc_an~a~ion 


5. Da.crib. l'r09%- W 
Sy.~a. 


7. 
Da~a 
Dic~ionary !Wpor~. 


10 JAJI 1985 - 
'14: 33 


SELEC~ION: ~ 
I 


.1 1i_..'!I]I.....Ji~~J'._~ ./ 


o 
STEP 
2: 


Action: 


Effect: 


Select the "Create or Modify Help Documenta- 
tion" (enthdoc) option. 


Enter a 4 as shown. 


The screen form displays as follows. 


(~an~hdOcJ 


I~w,__,. 


llJIIPY !l.laa.. 3.3 


Craa~a or Modify Halp 
DoCWllan~a~ion 


10 JAJI 1985 _ 14:33\ 


The "Create or Modify Help Documentation" screen allows you to 
accomplish just that. 


The prompt: 


MENUjPROGRAM 


allows you to specify the system name of a menu, program, ENTER 
screen, or SQL screen for which you want to create help information. 
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Creating Help Documentation 


[.nthdocl 
UNIFY R.le... 3.2 


Create or Modify Help Documentation 
10 JAN 1985 
- 
14: 22 


MENU/PROGRAM: 1nv1tmo. 


o 
STEP 
3: 


Action: 


Effect: 


• 


Specify the name of the report. 
Enter invitmo at the prompt as shown. 


The vi text editor starts for the file: 


••jhdocjinvitmo.n 


You can specify a different text editor by using 
the EDIT environment variable. For information 
on this subject, see the UNIFY Reference Manual, 
Section 1.1.4. 


l 


- .. /hdoc/invitmo.n- No auch file or directory 
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UNIfY Tutorial 


Note: 


o 
STEP 
4: 
Action: 


The screen display you see depends on the text 
editor. 


Create help text. 
Enter the following text: 


Inventory Ite= Overview 


Thiareport lists 
i~.m. in inventory, qrouped by d••cription and 
manufacturer. 
There i. 
& count and averaq••al•• price for ehe 
itama in each group. 


• .. /h~oc/invitmo.n· [Nev file] 
5 line•. 


0 
STEP 
5: 
Action: 
Effect: 


0 
STEP 
6: 
Action: 


Effect: 


Exit from the editor. 
Save the new file and quit the editor. 
The initial screen displays. 


Return to the menu. 


Press ICTRL! ill]. 
The "System Administration" menu displays as 
follows. 
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[sya..4m.inl 
UlrIFY Rale"sa 3.2 


SY.~.. Admini.~r4tion 


1. 
Tra"""ction Loqqinq Statua 


2. 
Data sa•• Maintenance 


3. 
SScurity llaintananca 


Creating Help Documentation 


10 JAll 
1985 
_ 
.,.: 22 


5. 
Describa Proqram to Syste.. 


7. 
Proqram Lo..4inq 


6. 
Dat.. Dictionary Raporta 


o 
STEP 
7: 


Action: 


Effect: 


Request help for "Inventory Item Overview." 


Enter the command as shown. 


The help documentation you entered displays as 
follows. 


Inventory Item Overview 


Thia report Ii.t. itema in inventory. grouped by 4••cription and 
manufacturer. There ia .. count and averaq. 8.1 •• price for the 
it8mA in each qroup. 


'-----------------------------------" 
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o 
STEP 
8: 


Action: 


Effect: 
Note: 


o 
STEP 
9: 


Action: 
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Return to the "System Administration" menu. 


Press IRETURNI. 
The menu redisplays. 


For all options listed on a menu, you can request 
help in one of three ways: 


• 
by number. Simply enter the number of the 
desired option as follows: 


SELECTION: help selection-number 


Here, you request help for the option referred to 
by the selection number. 


• 
by name. Enter the system name of the desired 
option as follows: 


SELECTION: help option-name 


Here, you request help for the option known to tt 
Menu Handler as option-name. 


• 
with the information command. Press the in- 
formation command key. 


Here, you request help for the current option, 
which is marked by the menu pointer. 


Return to the UNIFY Main Menu. 


Press ICTRLJ 00. 


( 


Section 12 
Modifying UNIFY Menus 


12. MODIFYING UNIFY MENUS 


In previous sections, you built several file maintenance ENTER 
screens (manf, model, and item), as well as several reports (invitmo, 
purchase, and acqIist). 
In this section, you will create a simple menu structure that will 
allow novice users access to these programs. The new menu 
structure you will create is as follows. 


Application Menu 
(usermenu) 
I 
I 
Report Menu 
(rptmenu) 
I 


I 
File Maintenance 
Menu (fmntmen) 
I 
I 
I 
I 
manf 
model 
item 
I 
item 
I 
invitmo 
I 
I 
purchase 
acqIist 


This iIlustrates how easy it is to build your own menus using UNlFY. 
o 
STEP 
1: 


Action: 


Effect: 


Select the "Add, Modify or Delete Menus" 
(menumnt) option from the "UNIFY Main Menu." 
Enter menumnt at the selection prompt. 


The following screen displays. 


UNIFY TutorIal 


(menumnt] 
1llfU'Y Releaaa 3. 2 
Ad4. M041fy or Delete Menua 


10 JAM 1985 - 
14: 22 


NAME:(i!1~Wi*'&'W1HEADIIfG:~_WiWili\l1iii&W~"'"manu el.ata entry areal 
amel. 
LINE 
MEIfU/PROG 
M/P 
PROM~ 


(I]NQllIRE. [A]DD. 
(M]ODIFY. 
(D]ELETE a. 


menu line 


data entry Are. 


The "Add, Modify or Delete Menus" screen allows you to inquire, 
add, modify, and delete menus and menu lines. 
There are two entry areas on this screen: the menu data entry area 
where you add the menu name and heading, and the menu line data 
entry area where you add, delete, and modify menu lines. 
The operation prompt: 


[I]NQUIRE. [A]DD. [M]ODIFY, [D]ELETE 


allows you to select an operation mode for the program. 


WHEN you want to... 
THEN select... 
view an existing menu 
i (inquire) 
create a menu 
a (add) 
add, modify, or delete lines on a menu 
m (modify) 
delete a menu 
d (delete) 
change the heading of a menu 
m (modify) 


The "Add, Modify or Delete Menus" screen has the following 
prompts and column headings. 
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NAME. This is a unique eight character menu name. It must 
be different from other menu, screen form, and program names. 


HEADING. This is a 34 character string that displays on the 
second line of the screen when the menu is active, and on other 
menus where this one is a selection option. 


amd. This is where you enter an operation command for the 
current menu line. The cursor marks the current menu line. 
You can move the cursor up or down in the menu line entry 
area of the screen form by pressing ICTRLI IQJ or IRETURNI. 
The valid operation commands are as follows. 


WHEN you want to... 
THEN enter... 
add a new line to the menu 
a (add) 
modify LINE or MENUjPROG for the 
m (modify) 
current menu line 
delete the current menu line 
d (delete) 
leave the menu line data entry area and 
q (quit) 
position the cursor at the HEADING prompt 


® 


( 


( 


( 


LINE. This is the position of the current menu line on the 
menu. You can enter a number from one to 16. The menu 
lines will be resorted in the new sequence when you enter 
ICTRLI IQJ from this column. 
MENUjPROG. This is the name of the menu, program, 
ENTER screen, or SQL screen that begins running when you 
select this menu line. 


® 
MjP. This is a "display only" field that indicates the type of 
this MENUjPROG entry. The characters that can appear in 
this column are defined as follows. 


CHARACTER 
DEFINITION 
M 
a menu 
P 
a program 
E 
an ENTER screen 
S 
an SQL screen 


o 
PROMPT. This is a "display only" field that shows what text 
displays on the menu for the current menu line. 
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The PROMPT field derives from: "Add, Modify or Delete 
Menus" (this program) for menus; "Describe Program to 
System" for programs; "Register Screen Form with ENTER" for 
ENTER screens; and "Register Screen Form with SQL" for SQL 
screens. 
o 
STEP 
3: 


Action: 


Effect: 
Reason: 


Select add mode. 


Enter an a at the operation prompt. 


The cursor moves to the NAl\fE prompt. 
You want to add the two new menus. 


(menumntl 
tA1DD 
UNIFY Rele.ee 3.2 


Add. Modify or Delete Me!?'1lA 


10 JAM 1985 - 1':22 


NA.."E: fmntmen 
HEADING: Pile X.intenance Xenu 


amd 
LINE 
MEIl1J/PROG 
M/P 
PROMP'1' 
a. 


o 
STEP 
4: 


Action: 


o 
STEP 
5: 


Action: 


Reason: 


Define a name and heading for the new menu. 
Enter the menu name, fmntmen, and its heading, 
File Maintenance Menu, as shown. 


Select menu line add mode. 


Enter an a in the amd column. 


You now want to add menu lines for this menu. 


tmenumntl 
tA1DD 
UHIFY Rele••• 3.2 


Add. Modify or Delete MenllA 


10 JAM 1985 _ 1':22 


NAME: fmntmen 
HEADIHG: Pile X.intenanc. X.nu 
amd 
LINE 
MEIl1J/PROG 
M/P 
PROMP'1' 


j 
...nf 
• 
• ..'O.ufactuzer ••intenance 
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o 
STEP 
6: 


Action: 


Define the first menu line. 


Enter the information for manf as shown. 


Reason: 


Effect: 


o 
STEP 
7: 
Action: 


Reason: 


o 
STEP 
8: 
Action: 


o 
STEP 
9: 
Action: 


Modifying UNIFY Menus 


The line number is 1 because it is the first 
selection option on the menu. 
The system displays the data for the MjP and 
PROMPT columns. 


End menu line add mode. 


Press ICTRLI ill! with the cursor in the LINE 
column. 


The lines are sorted according to the number in 
the LINE column. 


If two lines have the same number, the line you 
modified most recently is placed first. 


Select menu line add mode again. 
Enter an a again. 


Define the remaining two menu lines. 
Enter the data for model and item as shown. 


[m.numnt] 
[A]DD 


UNIFY R.1•••• 3.2 
A44. Mo4ify or D.let. M.n... 


10 JAW 1985 _ 14:22 


NAME: fmntm.n 
HEADING: Pile a.int.nanc:. a.nu 


am4 
bINS 
MENU/PROG 
M/P 
PROMPr 


1 
aanf 
Ie 
Xanufacturlr Xaintlnane. 
2 
.04&1 
II: 
ao4.1 a.int.nanc:. 


3 
;1tl= 
J: 
I.nventoi:y I.tell1 Xaintenance 


o 
STEP 10: 


Action: 


Reason: 


Complete this menu entry. 
Enter a q as shown to leave the menu line entry 
area. 


Then press ICTRL! ill! to clear the screen. 
You're ready to add the next menu. 
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[menumnt] 
[A]DD 


UNIFY Rele••• 3.2 


Add. Modify or D.lete M.nus 
10 JAN 1985 _ 14:22 


NAME: rptmenu 
HEADING: Report Menu 


amd 
LINE 
MENU/PROG 
M/P 
PROMPT 


1 
invitmo 
P 
Inventory It.em. OVerview 
2 
purcbaa. 
P 
Purcbae. 
Ac~.itiona 


3 
acqliat 
S 
Acquiaition P.riod 
"item 
E 
Inventory Item. Maintenance 


o 
STEP 11: 


Action: 
Note: 


o 
STEP 12: 


Action: 


Reason: 


Add the "Report Menu," rptmenu. 


Enter the information as shown. 


The reason for putting the ENTER screen item on 
this menu is because it has report options 
associated with it. 


Return to the operation prompt. 
Enter a q in the amd column. 


Then press ICTRU IQJ until the operation prompt 
displays. 
You're ready to modify an existing menu. 


[menumnt] 
UNIFY R.I•••• 3.2 


Add. Modify or Delet. M.nus 
10 JAN 1985 _ 14:22 


NAME: 
HEADING: 
amd 
LINE 
MENU/PROG 
M/P 
PROMP'l' 


[I]NQUIRE, 
[A]DD, 
[M)ODIFY. [D)ELETE.- 
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o 
STEP 13: 


Action: 
Reason: 


Modifying UNIFY Menus 


Select modify mode. 
Enter an m as shown. 
You're ready to change the "Data Entry Screens" 
menu. 


[,..numntl 
[MlODIFY 
UNIFY R.l•••• 3.Z 


Add, Modify or D.l.t. M.nu. 


10 JAN 1985 _ 14:2Z 


HAKE: 
QAeZ'menu READING: Data Btltry' Sex••n. 


amd 
LIIlE 
MENU/PROG 
M/P 
PROMP'l' 


1 
aanf 
• 
.anu,fac1:.uxeZ' Xaint.nance 
2 
.0d81 
I: 
Jlod.l Jlaint.nanc. 


3 
i.t.,. 
I: 
Inv.ntory It... JI.int.n.nc. 


o 
STEP 14: 


Action: 


Effect: 


Select the "Data Entry Screens" menu, usermenu. 


Enter the menu name as shown. 
The complete menu description displays. 


[,..numntl 
[MlODIFY 
UNIFY R.l•••• 3.2 


Add, Modify or D.l.t. M.nua 


10 JAN 1985 - 14:n 


( 


KAME: 
a.••rJD.enu HEADING: Application ••nu 


...d 
LIIlE 
MENU/PROG 
M/P 
PROMP'l' 


d- 
1 
aanf 
• 
..nu!&c1:.urer Xaintenanc. 
Z 
.od81 
I: 
Jlod.l Jlaint.nanc. 


3 
i.t... 
I: 
Inventory It... Jlaint.nance 


o 
STEP 15: 
Action: 


o 
STEP 16: 


Action: 
Effect: 


Modify the heading. 
Change the heading of this menu to "Application 
Menu," 


Delete the first line of the menu. 


Enter a d in the amd column as shown. 
The screen form displays as follows. 
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[rr.e :1WlU1t l 
(MlODIFY 
UNIFY R.I•••• 
3.~ 
Add, Modify or D.I.t. M.nua 


10 JAN 1985 _ 
14:~~ 


N~~E: 
U8ermenu HEADING: Application Manu 
amd 
LINE 
MENU/PROG 
M/P 
PROMPT 


ro. 
• 
1 
model 
E 
Model Maint.nenc. 
item. 
E 
Inventory Item. Maintenance 


Select menu line modify mode. 


Enter an m in the amd column as shown. 


0 
STEP 17: 


Action: 


0 
STEP 18: 


Action: 


Reason: 


Effect: 


Modify MENUjPROG. 


Change model to fmntmen. 


You're adding the "File Maintenance Menu" to 
this menu. 
The system displays the data for the MjP and 
PROMPT columns. 


The cursor moves to the LINE column. 
o 
STEP 19: 


Action: 


Effect: 


Complete the change. 


Press ICTRLJ illJ twice. 
The screen form display.s as follows. 


[menWl1nt l 
(MlODIFY 


UNIFY R.I•••• 
3.~ 
Add. Modify or D.I.t. M.nua 


10 JAN 1985 _ 14:22 


NA..\lE: usarmanu 
H&ADIHG: .&.pplication ••nu 


amd. LINE 
MENU/PROG 
M/P 
PROMPT 


• 
1 
fmntm.n 
• 
Pll••alnt.nene•••nu 
2 
.1te. 
• 
:Inventory 1 tam a.intananca 


o 
STEP 20: 


Action: 
Modify the second menu line. 


Press IRETURNI to get to line 2, then enter an m 
to modify this line. 


Change item to rptmenu. 


Press ICTRLI illJ to return to the amd column. 
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Effect: 


Modifying UNIFY Menus 


The final modification displays as follows. 


[.mnumnt] 
[MlODIFY 


OKIFY a.l•••• 3.2 


Add. M04ify or D.let. M.n.... 


10 JIiJI 1985 _ 14:22 


HAME: ""....m.nu 
HEADIllG: "'pplication ••nu 


amd 
LIllR 
MENU/paOG 
M/P 
paOMP'r 


1 
:fmntmen 
• 
Pila aaintanauca ••uu 


2 
rptm.nu 
• 
..port ••nu 


o 
STEP 21: 


A~tion: 


o 
STEP 22: 
Action: 
Effect: 


/ 


Return to the main menu. 
Enter a q as shown to leave the menu line entry 
area. 


Then press ICTRLI ll] until the main menu 
displays. 


Select the "Application Menu" (usermenu) option. 


Enter an 8 at the selection prompt. 
The menu displays as follows. 


[u••rmenu] 
OXIFY a.l.aa. 3.2 
Application M.nu 


2. a.port M.nu 


10 JIiJI 1985 _ 14:22 
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o 
STEP 23: 
Select either of the menu options. 


Action: 
Enter a 1 or a 2 at the selection prompt. 
Effect: 
Either the "File Maintenance Menu" or the 
"Report Menu" displays. 
In this section, you have seen how to modify and add to the standard 
system menus. You've added two new menus, and modified an 
existing one. UNIFY makes it easy to personalize the menus for your 
application. In the next section, you'll see how to control access to 
menus. 
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o 
STEP 24: 


Action: 
Reason: 


Return to the Applications Menu. 


Press ICTRLI lfl. 
You're ready to assign data base security. 


(. 


Section 13 
Assigning Data Base Security 


13. Assigning Data Base Security 
13.1 Setting System Parameters and Security 
13-2 
13.2 Setting User Group Privileges 
13-5 


13.3 Setting Individual User Privileges 
13-12 


13. ASSIGNING DATA BASE SECURITY 


In Section 12, you created an application menu for several data base 
maintenance screens and reports. This section shows you how to: 


• 
require that users identify themselves with an ID and password 
before being granted access to the system 
• 
control access to the system menus, screens, and reports, based on 
user ID 
The following subsections describe how to implement system security: 
• 
In Section 13.1, you will set the login security. After this, when 
a user wants to use the data base, the system grants access by a 
"login" screen. You will also change the System Heading for 
this application. 


• 
In Section 13.2, you will define a user group and its privileges. 
A user group is a collection .of individual users with similar access 
privileges. 
• 
In Section 13.3, you define an individual user and associated 
privileges. You will create privilege specifications for a clerk an4 
a supervisor. 
Providing Security 
The more information in your data base and the more people using 
it, the more concern there is for security. UNIFY provides internal 
security at four levels: login, menu, program, and field. 


• 
At the login level, the system displays a login screen requmng a 
user ID and password to access the data base. A super-user ID is 
available for the system administrator. 


• 
At the menu level, the system displays a menu according to the 
user's access privileges. When a user does not have access to a 
particular menu option, that option doesn't display. 


• 
At the program level. the system grants inquire, add, update, and 
delete capabilities according to the user's access privileges. When 
a user does not have permission to perform an operation, that 
.operation is not presented. 


• 
At the field level, the system allows access to data base fields 
according to separate read and write passwords. If a user does 
not supply the correct password, the data field isn't accessible. 


UNiFY Tutorial 


The UNIFY Reference Manual explains the programs that set data 
base security as follows. 


UNIFY Program 
Type of Security 
Section 
Modify System Parameters 
login screen, 
3.1.1 
& Security 
super-user ID, and 
password 
Add or Modify Group 
menu and program 
3.1.2 
Privileges 
Add or Modify Individual 
menu, program, 
3.1.3 
Privileges 
and login 
password 
Field Security Maintenance 
field 
3.1.6 


13.1 SEITING SYSTEM PARAMETERS AND SECURITY 


At this time when you start UNIFY, the system grants you direct 
access to the data base. This condition is the default setting. 


UNIFY, however, provides for an optional login screen. This screen 
requires that users identify themselves before being granted access to 
the data base. 


A complete user ID consists of a user code (login ID) and a 
password. The system validates user ID's by looking them up in the 
data dictionary. It then passes the information to the Menu 
Handler. It is the Menu Handler that i!1terprets menu and program 
privileges and, therefore, establishes security. 


To enable the login screen, you use the "Modify System Parameters 
& Security" option. This option is listed on the "Security 
Maintenance" menu. 
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/ 


[ua.rm.nuJ 


SE~ECTIOH: ••curity. 


OKlFY a.l•••• 3.2 
Application M.nu 


2. a.port M.nu 


Assigning Data Base Security 


10 JItJf 1985 _ 1.: 22 


o 
STEP 
1: 


Action: 


Effect: 


Access the "Security Maintenance" menu 
(security). 


Enter the menu name at the selection prompt as 
shown. 


The menu displays as follows. 


r.·curity] 
WAUHOUSE IIlV!:HTOaY SYSTEM 
S.curity Maint.""nce 


10 JItJf 1985 - 1':22 


\. 


SE~ECTIOH: 
• 


2. Add or Modify Group Privilag.. 


3. Add or Modify Individual Privilegee 


•• Print Group Privilegee 


5. Print Individual Privil.ge. 


6. Piald S.curity Meinte""nc. 


7. Proce•• Pield Pa••word. 
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[J 
STEP 
2: 


Action: 
Effect: 


Select the "Modify System Parameters & 
Security" (parmnt) option. 
Press the select command key. 
The following screen form displays. 


UIIUT ll.l 
3.2 
10 JAM 1985 - 1.: 22 
1l000fy SY.1:.. P.." 
1:.". " 
S.c=11:y 


supn USBll II) 
: 
<D 


PMSVOllD 
: 
0 


EftllY POIft 
: -1_...u0 


SYS~1:lI B&ADIIIG : 1IIIIrY lld...... 3.20 


1l0ftB IlIII:lIOIlICS: JJoIIFSIIIlAJAPllIlAYJ11IIJmJoUGSEPOC'rIlOVl)EC® 


ILOCD / 
VOLllIIII: 2000® 


I.OGDlFLo\G ('r/P): P 0 


The "Modify System Parameters & Security" screen allows you to 
change the parameters of the system. The screen form has the 
fOllowing prompts. 
CD 
SUPER USER ID. This is an eight character string 
(maximum) that identifies the super user. The super user 
enters this code to log in to the data base. 
o 
PASSWORD. This is an eight character code (maximum) the 
super user enters after entering the login ID. 
o 
ENTRY POINT. This is the name of the menu the super user 
sees after logging in. 


@ SYsrEM HEADING. This is a SO character string that 
displays on the first line of each screen form and menu in the 
application system. 
. 
o 
MONTH MNEMONICS. This is a 36 character string with 
three characters representing each month of the year. The 
string displays in the upper right corner of each screen form 
and menu in the application system. 


® 
BLOCKS / VOLUME. This is an integer that tells the 
··Read/Write Data Base Backup" and "Reconfigure Data 
Base" functions how many 4k (4096 bytes) blocks fit on a 
volume of the backup device. The system backup device is 
either a tape or floppy disk. 
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(2) 
LOGINFLAG (TIF)· This option controls whether a login 
screen displays when a user starts UNIFY. The default mode is 
F (false) for no login screen. 


[parmnt] 


StlPEIt USEIt 1D 
: a.. 


PASSWORD 
: ... 


tllIl:FY It.l 
3.~ 
10 JJt)f 1985 - 
14:~~ 
1I041fy Sy.t.a P." 
ter. '" S.cu.r1ty 


EHTItY POIHT 
: _1......... 


SYSTE!! llEADIHG 
: VARElIOtlSII IIlVEJl'l'OItY SYSTEM 


1I0HTll lIHEl10Ill:CS: ,)"AIfF!:IlIIA1lAPIllIAYJtIHJllLAtlGSEPOCTHOVDEC 


BLOCXS / 
VOLtIlIII: 2000 


LOG1IIFLAG (T/P): ". 


0 
STEP 
3: 
Modify the SYSTEM HEADING prompt. 


Action: 
Change the system heading from UNIFY Release 
3.2 to WAREHOUSE INVENTORY SYSTEM as 
shown. 


0 
STEP 
4: 
Modify the login screen flag. 


Action: 
Move the cursor to the last prompt, LOGINFLAG, 
and change the no login screen flag from F to T 
(true) as shown. 


0 
STEP 
5: 
Return to the Menu Handler. 


Action: 
Move the cursor to the first prompt and press 
ICTRLI IDJ. 


Reason: 
You're ready to set user group privileges. 


13.2 SETTING USER GROUP PRIVILEGES 


Users can generally be classified into groups in terms of the menus, 
programs, and screens they need to use. UNIFY lets you define such 
groups, so you can assign privileges quickly to users with similar 
security needs. 
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(aecuri~Yl 
CWXYf a.l.aa. 3.2 


8.cuzi~y Haint.DAnc. 


10 JAM 1985 _ 1.:22 


2. Ad4 or H04ify Group Privil.'lu 


3. Ad4 or H04ify In4ivi4ual Privil.'l•• 


•. 
Prin~ Group Privil.'l•• 


5. Print Indivi4ual Privil.'l•• 


6. Pi.14 
8.cuzi~y Haint.DAnc. 


1. Proc••• Pi.14 pa••wor4e 


SELECTION: 2- 
\1. 
IHljUrWrmr· 
TilllE 
1_lIil 
Ii 
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o 
STEP 
6: 


Action: 
Effect: 


Select the "Add or Modify Group Privileges" 
option. 
Enter a 2 as shown. 
The following screen form displays. 


(grpmnt] 
llAllEBOUSII UIVIIII'1'ORY SYSTEM 
A44 or M04ify Group Privilag.. 


Assigning Data Base Security 


10 JAM 1985 _ 
14:~~ 


ACCESS LEVELS: 
LX 
MIIW/PROG M/P 
IIIQ ADD MOD DilL 
LX 
MIIW/PROG M/P 
IIIQ ADD MOD DilL 


accaaa privilaga 


paging araa 


The "Add or Modify Group Privileges" screen allows you to inquire, 
add, modify, and delete user groups and their access privileges. 
There are two data entry areas on this screen: the group data entry 
area and the access privilege data entry area. There is also an 
access privilege paging area. 
The operation prompt: 


[I]NQUIRE, [A]DD, [M]ODIFY, [D]ELETE 


allows you to select an operation mode for the group data entry area. 


WHEN you want to... 
THEN select... 
view the access privileges of a user group 
i (inquire) 
add a user group and its access privileges 
a (add) 
change the access privileges of a user group 
m (modify) 
delete a user group and its access privileges 
d (delete) 
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The "Add or Modify Group Privileges" screen form has the 
following prompts and column headings. 
CD 
GROUP ID. This is a four character code that identifies the 
user group. 


e!) 
NAME. This is a 30 character string for the user group name. 
This name is used for identification and documentation only. 


® 
SYSTEM ENTRY PT. This is the system name of the menu 
that users in this group see after they log in to UNIFY. 


@) 
column to the left of LN. There is no name for this column 
because of space restrictions. It corresponds to the CM:D 
column on the data base design's record entry screen. 
This is where you enter an operation command for the current 
access privilege. The cursor marks the current line. You can 
move the cursor up or down this column while in the paging 
area by pressing ICTRL! IQ] or IRETURNI. 
The valid operation commands are as follows. 


WHEN you want to... 
THEN select... 
modify INQ, ADD, MOD, or DEL for the 
m (modify) 
. current access privilege 
delete the current access privilege 
d (delete) 
leaveithe current entry mode and redisplay the 
q (quit) 
paging prompt 
® 
LN. The system generates this line number. When you want to 
modify the access privilege, you can use this number as a 
reference. 


® 
MENUjPROG. This is the name of the menu, program, 
ENTER screen, or SQL screen that users in this group can 
access. 


(2) 
MjP. This is a display only field that indicates the type of 
MENUjPROG entry. The definitions of the characters that 
appear in this column are as follows. 


CHARACTER 
DEFINITION 
M 
a menu 
P 
a program 
E 
an ENTER screen 
S 
an SQL screen 
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® 
INQ. A Y in this column indicates that users in this group can 
use inquire mode with the named option. An N indicates they 
cannot. 


® 
ADD. A Y in this column indicates that users in this group can 
use add mode with the named option. An N indicates they 
cannot. 
@ 
MOD. A Y in this column indicates that users in this group 
can use modify mode with the named option. An N indicates 
they cannot. 


@ 
DEL. A Y in this column indicates that users in this group can 
use delete mode with the named option. An N indicates they 
cannot. 


The paging prompt: 


[N]ext page, [p]rev page, [A]dd line, or number: 


allows you to choose the operation mode for the paging area. Each 
selection is as follows. 


WHEN you want to..: 
THEN select... 
display the next page of access 
n (next) 
privileges 
display the previous page of access 
p (previous) 
privileges 
add access privileges 
a (add) 
access the privilege on line nnn for 
1-999 
modification or deletion 


( 


( 


o 
STEP 
7: 


Action: 


Effect: 


Add a user group. 


Enter an a at the operation prompt. 


The prompt erases and the cursor moves to the 
GROUP ID: prompt. 
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[grpmntl 
[AlDD 
WAREBOUSB 
IHVEIl'1'ORY SYSTEM 
Ad4 or Modify Q<oup Privil.q•• 
10 
JAIf 1985 _ 14'22 


GROUP 10' 
DEC 
1lAME: !let. Bntry Cl.ra 
SYSTEM DlTRY PT: ....rm.nu - • 


ACCESS U:VZLS' 
LN 
MENU/PROG lVP 
DlQ ADD MOD t1!:L 
Uf 
MENU/PROG lVP 
DlQ ADD MOD t1!:L 


[NJ."t peq•• [PJrev peq•• 
[AJ44 Un., or llUlIlI>.r: .. 


D 
STEP 
8: 


Action: 
Effect: 


D 
STEP 
9: 
Action: 
Effect: 


Define the Data Entry Clerk group. 
Enter the information as shown. 
When you enter the name of the system entry 
point, the paging prompt displays at the bottom of 
the screen as shown. 


Select "add privilege" mode. 
Enter an a at the paging prompt. 
The prompt erases and the cursor moves to the 
access privilege data entry area in the 
MENUjPROG column. 


[""pmntJ 
[AlDD 
WAREBOUSB IIlV&Il'1'ORY SYSTEM 
.\44 or Kodify Group Privil.q•• 
10 JAIf 1985 _ 14:22 


GROUP 10: 
DBC 
lIAIIB: Oat. Entry Cl.ra 
SYSTEM ENTRY PT: ,...rm.nu _ K 


ACCESS L&VBLS: 
LN 
MENU/PROG lVP 
INQ ADD KOD DEL 
...nf 
B 
lC 
y 
Y 
n 
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LN 
KENU/PROG K/P 
INQ ADD KOD DEL 


o 
STEP 10: 


Action: 


o 
STEP 11: 


Action: 


Effect: 


Assigning Data Base Security 


Define the access privilege to the "Manufacturer 
Maintenance" ENTER screen. 


Enter the definition as shown. 


Move the definition to the paging area. 
Press ICTRLI IQ] with the cursor in the INQ 
column. 
The definition moves to the paging area and the 
data entry area clears so you can add a new access 
privilege. 


(grpmnt] 
(A]DD 
lfAREHOUSB IIlVEIl'l'ORY SYSTEM 
A4d or Mod1fy Group Pr1v11aqa. 


10 JAM 1985 _ 14:22 


GROUP ID: 
DBC 
HAMS: D.t. B"try Cloru 
SYSTEM BKTRY PT: u..r:mo"u - M 


ACCBSS LBVBLS: 
Llf 
MBlfU/PROG M/P 
IlfQ ADD MOD DBL 


1 
IllAnf 
B 
Y 
y 
y 
" 
2 
modol 
B 
y 
Y 
Y 
" 
3 
1t_ 
S 
y 
Y 
Y 
" 
4 
fmntmo" 
M 
5 
rptmen 
M 


Llf 
MEKU/PROG M/P 
IHQ ADD MOD DEL 


(If]oxt paqo. (P]rav paqo, (A]dd 11"0. or "umbor: - 


0 
STEP 12: 
Complete the access privileges for the Data Entry 
Clerks. 
Action: 
Enter the information as shown. 


a 
STEP 13: 
Redisplay the paging prompt. 


Action: 
Press ICTRLI IQ] with the cursor in the 
MENUjPROG column. 


a 
STEP 14: 
Return to the Menu Handler. 


Action: 
Pre~s ICTRLI IQ] until the menu displays. 
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13.3 SETIING INDIVIDUAL USER PRIVILEGES 


After defining a group and its access privileges, you can enter 
information for the individuals in that group. 


o 
STEP 15: 


Action: 


Reason: 


Effect: 


Select the "Add or Modify Individual Privileges" 
(empmnt) option. 


Enter a 3. 
You're ready to add the individual privileges. 


The following screen form displays. 


[ompmntl 
WAllEKOUSB IIlVl':N'l'ORY SYSTEll 
10 JItJI 1985 - 14:22 
1044 0" M04ify In4ivi4ual P"ivile.... 


ACCESS LEVl':L8 DIPPl':1IEH'1' PROM GROUP: 
LX 
MENU/PROG M/P 
ACCESS? 
INQ ADD MOD DBL 


[I INQUIRE. [AJDD. [MJODIFY. [DJELBTB: a 


I 
ace••• p"ivila..a i 


data entry ar.. ! 
I 


&cc••• privileq. 
po..in,. a"a. 


The "Add or Modify Individual Privileges" screen form allows you to 
inquire, add, modify, and delete users and their access privileges. 
There are two data entry areas on this screen: the individual data 
entry area and the access privilege data entry area. There is also an 
access privilege paging area. 
The prompts on the screen form represent privileges that specify the 
differences between the user and the group. The privileges of the 
group determine the basic privileges of the user. You can override 
the group privileges by making entries with this program. 
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The operation prompt: 


[I]NQUIRE, [A]DD, [M]ODIFY, [D]ELETE 


allows you to select an operation mode for the individual data entry 
area. 


WHEN you want to... 
THEN select... 
view the access privileges of a user 
i (inquire) 
add a user and the associated access privileges 
a (add) 
add, modify, and delete access privileges of a 
m (modify) 
user 
delete a user and the associated access 
d (delete) 
privileges 


The "Add or Modify Individual Privileges" screen form has the 
following prompts and column headings. 
CD 
LOGIN ID. This is a four character code that identifies the 
individual. The individual uses this code to log in to UNIFY at 
the login screen. 


® 
NAME. This is a 30 character string for the individual's name. 
The name is used for identification and documentation only. 


CD 
GROUP ID. This is a four character code that identifies the 
individual's group. 
o 
NAME. 
T~is is a display only field that indicates the name of 
the individual's group. 


® 
PASSWORD. This is an eight character code the user enters 
on the login screen to access the data base. 


® 
SYSTEM ENTRY PT. This is the name of the menu the 
individual sees after logging in to UNIFY. It defaults to the 
System Entry Point of the group. You can, however, change 
the name· specifically for the individual. 
o 
column to the left of LN. There is no name for this column 
because of space restrictions. This is where you enter an 
operation command for the current access privilege. The cursor 
marks the current line. You can move the cursor up or down 
the column while in the paging area by pressing ICTRLI JD] or 
IRETURNI. 


The valid operation commands are as follows. 
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WHEN you want to... 
THEN enter... 
modify ACCESS, INQ, ADD, 
m (modify) 
MOD, or DEL for the current 
access privilege 
delete the current access privilege 
d (delete) 
redisplay the paging prompt 
q (quit) . 


®. 
LN. The system generates this line number. When you want to 
modify the access privilege, you can use this number as a 
reference. 


® 
MENU/PROG. This is the name of the menu or program that 
the individual can access differently than other users in the 
group. 
M/P. This is a display only field that indicates the type of 
MENU/PROG entry. ·Each entry indicates the current access 
privilege. The definitionsfor the character codes are as follows. 


CHARACTER 
DEFINITION 
M 
a menu 
P 
a program 
E 
an ENTER screen 
S 
an SQL screen 


@ 


@ 


ACCESS? 
A Y in this column indicates that individuals can 
access the named option. An N indicates they cannot. 


INQ. A Y in this column indicates that individuals can use 
inquire mode with the named option. An N indicates they 
cannot. 


ADD. A Y in this column indicates that individuals can use 
add mode with the named option. An N indicates they cannot. 
MOD. A Y in this column indicates that individuals can use 
modify mode with the named option. An N indicates they 
cannot. 
DEL. A Y in this column indicates that individuals can use 
delete mode with the named option. An N indicates they 
cannot. 


The paging prompt: 


[N]ext pag~ [P]rev pag~ [A]dd lin~ or number: 


allows you to choose the operation mode for the paging area. Each 
selection is as follows. 
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WHEN you want to... 
THEN select... 
display the next page of access 
n (next) 
privileges 
display the previous page of access 
p (previous) 
privileges 
add access privileges 
a (add) 
access the privilege on line nnn for 
1-999 
modification or deletion 


0 
STEP 16: 
Action: 
Effect: 


0 
STEP 17: 


Action: 


Effect: 


Select add mode. 
Enter an a at the operation prompt. 


The prompt erases and the cursor moves to the 
LOGIN ID: prompt. 


Define the supervisor of the Data Entry Clerk 
group. 
Enter the information as shown. 


When you enter the group ID. the system displays 
the group name and the system entry point. 


t.oGIII I)): 
aaa 


GROUP I)): 
DEC 
PASSWORD: 
acaa 


WAREHOUSE I~RY SYSTEM 
A4d or Modify Individual Privilaqaa 


1fAMB: saaual S. Spada 
1fAMB: DaU Snl:ry Claru 
SYSTEM SIl'r1lY PT: Il&i_anu 
_ M 


10 JAIl 1985 _ 14:22 


( 


ACCESS LEVZLS DUl'ZUII'1' FROM GROUP: 


LII 
MEIl11/PllOG M/P 
ACCSsa? 
IKQ AD)) MO)) ))EL 


[I]KQUIU, [Aj)))), [M]ODIlT, [))]BLSTE: • 
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0 
STEP 18: 
Modify the system entry point. 
Action: 
Change the system entry point from usermenu to 
mainmenu as shown. 


0 
STEP 19: 
Display the paging prompt. 
Action: 
Press IRETURNI to move past the SYSTEM 
ENTRY PT: prompt. 
Reason: 
You're ready to add access privileges for the 
supervisor. 


0 
STEP 20: 
Select "add privilege" mode. 
Action: 
Enter an a. 


[ ...pmneJ 
[AJOO 


LOGIN 10: a •• 
GROUP 10: DEC 
PASSWORD: ac•• 


lfAREBOl1SIi IJlVEJI'1'ORY SYSTU 
Add 0" Kodify IndividUAl P"ivU.q.. 


H4ltlS: Saau.l S. Spada 
H4ltlS: Dae& linUy Clarita 
SYSTU liftRY PT: _i"..enu -. 


10 JItJf 1985 - '.:22 


ACCESS LEVELS OIFFEUHT PROK GR011P: 
LN 
KEW/PROG It/p 
ACCESS? 
IHQ ADO KOD DEL 
manf 
Ii 
:J 
Y 
Y 
Y 
Y 
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o 
STEP 21: 


Action: 
Effect: 


Note: 


Define the first access privilege. 
Enter the information as shown. 
This entry allows the supervisor to delete 
manufacturer records. Other group members do 
not have this privilege. 
You can clear the data entry area and move the 
new access privilege to the paging area by pressing 
ICTRLI n:n with the cursor in the ACCESS 
column. 


(empmntJ 
(AJDD 


LOGI:H m: ... 
GROUP m: 
DEC 
PASSWORD: ace. 


llARJIBOUSII 
DlVEHTORY SYSTEIl 
hid. or Mo4ify I:nd.ivid.ual PrivUoqo. 


IlAMII: samu.l S. 
Spad.e 
IlAMII: Data Entry Clerka 


SYSTZlt IINTRY PT: _inmenu -. 
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10 JAN 
1985 
- 
14: 22 


ACCESS 
LEVELS DIFFJlRENT 
FROM GROUP: 


LH 
MEW/PROG M/P 
,\CCIISS? 
INQ ADD 
MOD DEL 


1 
_nf 
B 
Y 
Y 
Y 
Y 
Y 
2 
_01 
B 
Y 
Y 
Y 
Y 
Y 


3 
J.te... 
B 
y 
Y 
Y 
Y 
Y 
• aql 
P 
Y 


5 
uermenu • 


(Hjort peqe, 
(PJrev p"qo, 
(AJd.d. lino. or numbor: 
- 


o 
STEP 22: 


Action: 


Note: 


o 
STEP 23: 


Action: 


Reason: 


Complete the access privileges for the supervisor. 


Enter the information as shown. 
When you want to redisplay the paging prompt, 
press ICTRLI IQ] with the cursor in the 
MENUjPROG column. 


Clear the screen. 


Press ICTRLI IQ] until the screen clears but you 
remain in ADD mode. 


You're ready to add a new user. 
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[ampmntJ 
[AJOO 


lIAllEHOllSII 
DlVEII'l'ORY SYSTEM 
Add or Mcd1fy IDd1vidUAl Pr1v1la'1" 


10 JAJI 
1985 
_ 
14: 22 


LOGIli II): 
jhd 
HAMIl: 
.John H. 
Doa 
GROUP 
II): 
DEC 
.HAMIl: 
Data Ifntry Clarka 


PASSWORD: 
a!>cdaf'1 
SYSTEM EllTRY PT: _arma"u -. 


ACCIISS UVEI.S OIF!'!:REIlT 
FROM 
GIl0UP: 
Lll 
MENU/PROG M/P 
M:CIIS8? 
DlQ ADO 
MOD DEI. 


[I JllQUIRE. 
[AJOO. 
[MJODIFY. 
[DJIII.IITII: 
a 


0 
STEP 24: 
Define a Data Entry Clerk. 


Action: 
Enter the information on the clerk as shown. 
Note: 
Since the clerk's access privileges are not different 
from the group, you need not enter additional 
information. 


0 
STEP 25: 
Return to the active menu. 
Action: 
Press ICTRLI IDl until the menu displays. 
Reason: 
You're ready to see how· the Menu Handler 
controls system security. 


0 
STEP 26: 
Quit UNIFY. 


Action: 
Press the exit command key. 


0 
STEP 27: 
Start UNIFY. 
Action: 
Type unify at the operating system prompt. 


Effect: 
The UNIFY System Startup (login) screen displays 
as follows. 
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LOGIN 
888 


PASSWORD: 


WAREHOUSE INVENTORY SYSTEM 
SYSTEM STARTUP 
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10 JAN 1985 - 
14:22 


o 
STEP 28: 


Action: 


Note: 


Effect: 


Login as the data entry supervisor, Sam Spade. 


Enter the login rD, sss, and the password, aces. 


When you enter the password, it does not display 
on the screen form. This is for additional security. 


The following screen form displays. Notice that 
the system menu is not displayed for this user. 


[ma.inmanu] 
WAREHOUSE INVENTORY SYSTEM 
UNIFY Main Manu 


2. Application Manu 


10 JAN 1985 - 
14:22 


~.. 


o 
STEP 29: 


Action: 


Quit UNIFY again. 


Press the exit command key. 
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LOGIN 
jhd 


PASSWORD: 


WAREHOUSE INVENTORY SYSTEM 
SYSTEM STARTUP 


10 JAN 1985 
_ 14:22 


o 
STEP 30: 


Action: 


Effect: 


Start up UNIFY again, and login as the data entry 
clerk, John poe. 
Enter the login ID, jhd, and the password, abcdefg. 


The following menu displays. 


u.sermenu] 
WAREHOUSE INVENTORY SYSTEM 
Application Manu 


2. Report Menu 


10 JAN 1985 _ 14:22 


Note: 
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Only options accessible from the "Application 
Menu" are available to this user. This is an 
example of how UNIFY restricts access to 
programs and menus. 


Even if the user knows the system name of a 
restricted program, the Menu Handler will prevent 
the user from running the program. 


Assigning Data Base Security 


In Conclusion 


By following the steps in the UNIFY Tutorial, you have: 


• 
.created a directory structure and become familiar with the use of 
UNIFY menus, command keys, help text, and menu options 


• 
created a data base, data entry screen forms, and a menu with 
the quick and easy one step development facility called ··Design 
and Create a New Data Base" 


• 
added test data for each record type to establish the inventory 


• 
modified the data base design and reconfigured the data base 
• 
changed the data entry screen forms to reflect the new design 
using the full screen forms editor PAINT 


• 
used the UNIFY query and data manipulation language, SQL 


• . wrote a report using the UNIFY report processor, RPT 


• 
used the Query by Forms capability of ENTER to retrieve data 
and generate reports 


• 
written comprehensive help information by quickly specifying the 
system name of a menu, program, ENTER or SQL screen, and 
starting up an editor 


• 
personalized the menus for your application by adding two new 
menus and modifying an existing one 


• 
assigned security, to require user identification before being 
granted access to the system, and to control access to the system 
menus, screens, and reports based on user ID 


While this concludes the UNIFY Tutorial, you can continue using it 
as a reference to develop your own application. Other references you 
can use include the following. 


• 
The UNIFY DBMS Demo Handbook 
• 
The UNIFY Reference Manual 


• 
The UNIFY Programmers' Manual 
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Access privileges, 13-1 
acqlist.r RPT script, 10-4 
acqlist.s SQL script, 10-4 
Acquisition Period (acqlist), 10-9 
Add, Modify or Delete Menus (menumnt), 12-2 
Add or Modify Group Privileges (grpmnt), 13-7 
Add or Modify Individual Privileges (empmnt), 13-12 
after 
name, 7-10 
report, 7-13 
Aggregate functions, 6-16, 7-10 
and keyword in SQL, 6-12 
Application Menu (usermenu), 12-9 
Arithmetic expressions in SQL, 6-13 
Ascending order sorts in SQL, 6-15 
ASCII files 
input for RPT, 7-1 
input for SQL, 6-26 
output from Report Option Screen, 7-17 
output from SQL, 6-26 
Asterisk 
as a wild string, 9-6 
indicating the primary key, 2-2 
avg keyword in SQL, 6-16 


B 


Backup, see Write data base backup 
before 
name, 7-10 
report, 7-8 
Boolean expressions, 6-12 
Brackets, 6-12, 7-9 
B-tree index, 9-14 
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Calculating numeric values with SQL, 6-13 
Changing field values, 3-3 
Character 
count, 7-9 
special, 9-6 
strings, 7-9 
Clauses 
delete, 6-33 
from, 6-7, 6-24 
group by, 6-18, 6-22 
having, 6-22 
insert, 6-28 
into, 6-26, 6-28 
order by, 6-15, 6-23 
update, 6-31 
where, 6-7, 6-13, 6-18, 6-19, 6-23, 6-25 
Column (C:) cursor coordinate in PAINT, 5-5 
Combination fields guidelines, 5-19 
Command 
. 
key line, 1-5 
keys, 1-6 
key- set, 1-5 
name, 1-5 
scripts, 8-2 
Command-groups, 7-5 
Compound boolean expressions, 6-12 
Constants, 6-13, 6-20, 6-28, 7-9 
Control break in RPl', 7-5 
Correcting mistakes in field definitions, 2-13 
Count 
character, 7-9 
function, 6-17 
registers, 9-9 
Create Data Base? option, 2-21 
Create Data Entry Screens? option, 2-22 
Create Menu? option, 2-22 
Create or Modify Help Documentation (enthdoc), 11-3 
Create or Modify Screen Forms (screens) menu, 5-2 
Current Items Listing, 9-27 
Current Items Report, 9-32 
Current record types in SQL, 6-31 
Cursor 
coordinates in PAINT, 5-5 
explained, 1-2 
motion commands in PAINT, 5-7 
positioning on the screen form, 3-2 


'2 


Customer record type 
adding, 4-6 
explained, ix 


D 


Data 
dictionary, 1-2 
type lengths, 2-11 
Data base 
create phase, 2-19 
design phase, 2-3 
development options, 2-21 
field record types, 5-5 
security, 13-1 
size parameters, 2-21 
Data base design 
entering, 2-3, 2-19 
modifying, 4-1 
printing a report, 4-15 
reconfiguring, 4-16 
report, 2-2 
Data Base Design Utilities (dbdesign) menu, 4-5 
Data dictionary reports, 4-3 
Data Entry Screens (usermenu) menu 
creating, 2-22 
modifying, 12-7 
options, 3-1 
Data Manipulation Language (DML), 6·2, 6-28, 6-31 
Dates 
acquisition period, 10-19 
entering, 3-7 
fields, 6·13 
Default 
field widths in RPT, 7-12 
screen form, 2·22 
setting for security, 13-2 
values, 6·28 
delete keyword in SQL, 6-33 
Descending order sOrts in SQL, 6-15 
desc: keyword in RPT, 7-14 
Describe Program to System (execmnt), 8-5 
Design and Create a New Data Base (dbcreate), 2-5 
detail keyword in RPT, 7-11 
Dictionary, data, 1-2 
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Directories 
bin, 1-1 
hdoc, I-I 
lib, 1-1 
standard UNIFY, I-I 
structure of, 1-1 
uld,8-7 
DML (Data Manipulation Language), 6-2, 6-28, 6-31 


E 


edit 
environment variable, 11-3 
keyword in SQL, 6-8 
Editing 
commands, 5-6 
help documentation, 11-1 
session with PAINT, 5-5 
SQL queries, 10-5 
Edit SQL or RPT Command Files (edit) option, 10-5 
end keyword 
in RPT, 7-15 
in SQL, 6-34 
ENTER 
adding data with, 3-1 
count registers, 9-9 
guidelines, 5-19 
query by forms, 9-1 
registering reports with, 9-17 
Report Options Screen, 9-32 
screens, 3-1 
Entering a field definition, 2-12 
Entering a record type definition, 2-7 
ESC command key in PAINT, 5-11 
Exact matching, 9-5 
Executables, registering, 8-1 
Explicit relationships 
described, 2-2 
to optimize joins, 6-25 
with secondary record types, 3-2 
Expressions 
arithmetic, 6-13 
boolean, 6-12 
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Field 
combination, 2·11 
defining, 2·8 
description, vi 
level of security, 13-1 
type default lengths, 2·11 
values for ENTER, 3·2 
Field entry screen, 2·8 
fields keyword in SQL, 6-5 
Field types 
AMOUNT,2·1O 
COMB,2-10 
DATE,2·10 
FLOAT,2-10 
NUMERIC, 2-10 
STRING,2-10 
TIME,2-10 
File Maintenance Menu (fmntmen), 12·1 
Cooter keyword in RPT, 7·5 
Cromkeyword in SQL, 6·7, 6-24 
Full-screen editor in PAINT, 5-2 
Functions, aggregate, 6-16 


G 


Generate reports with ENTER, 9·1 
Generic matching, 9·5 
"group by keyword in SQL, 6·18, 6·22 
Group priviliges, setting, 13·5 
Guidelines on creating screen forms, 5·19 


H 


Hardware or software failure, 4·16 
Hash index, 4-20 
having keyword in SQL, 6-22 
header keyword in RPT, 7·8 


Index 
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Headings 
menu, 1-4 
program, 12-3 
Help 
by option name, 11-6 
by selection number, 11-6 
documentation, 11-1 
PAINT,5-11 
SQL,6-3 
text, 1-7 
with the information command, 11-6 
Home 
command key, 1-6 
menu, 1-3 


I 


ID 
group, 13-1 
individual, 13-1 
login, B-2 
super user, 13-4 
Individual user privileges, setting, 13-12 
Inexact matching, 9-5 
Inner SQL query, 6-20 
Input file for RPT, 7-1 
Input section in RPT, 7-7 
insert keyword in SQL, 6-28 
into keyword in SQL, 6-26 
Inventory Item Maintenance (item), 3-7 
Inventory Item Overview 
help documentation, 11-4 
report, 8-1 
invitm.s SQL script, 8-1 
Item Order Listing, 9-29 
Item record type 
adding, 2-17 
explained, vii 
itmlist.r RPT script, 9-23 


J 


Join queries, 6-24 
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K 


Keys 
primary, 2-2 
secondary, 2-2 
Keywords 
RPT,7-19 
SQL,6-1 


L 


Left margin command in RPT, 7-15 
Level break in RPT, 7-5 
Line (L:) cursor coordinate in PAINT, 5-5 
lines keyword in SQL, 6-27 
Listing processor (LST), 9-19 
Literal tuple, 6-30 
Logging in to UNIFY, 1-1 
Login 
ro, 13-2 
level of security, 13-1 


M 


Major sort expressions in RPT, 7-14 
Manf record type 
adding, 2-8 
explained, 2-2 
Manufacturer 
records, adding, 3-3 
record type, vi 
_ Manufacturer Maintenance (mant), 3-1 
Margins in RPT, 7-15 
Matching 
exact, 9-5 
generic, 9-5 
inexact, 9-5 
Matching parameters in SQL, 10-2 
max keyword in SQL, 6-16 
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Menu 
components, 1-4 
driven, 1-3 
level of security, 13-1 
Menu Handler 
describing programs to, 8-1 
explained, 1-3 
Menus 
creating, 12-1 
modifying, 12-7 
using, 1-7 
min keyword in SQL, 6-16 
Minor sort expressions in RPT, 7-14 
Model Maintenance (model), 3-5 
Model record type 
adding, 2-14 
explained, vi 
Modes 
append in PAINT, 5-12 
background in ENTER, 9-33 
command in PAINT, 5-11 
debug in ENTER, 9-21 
foreground in ENTER, 9-33 
input in PAINT, 5-11 
operation in ENTER, 3-2 
Modify Data Base Design (schent); 4-5 
Modify System Parameters & Security (parmnt); 13-4 
Multiple 
file queries 6-24 
sorts, 6-15 
Multiple level, tabular reports in RPT, 7-1 


N 


Nested SQL queries, 6-19 
Nonprocedural language in RPT, 7-1 


Non~string fields, inexact matching on, 9-6 
o 


On-line help documentation, 1-7 
Operation command, 2-9 
Operations in ENTER, 9-5 
order by keyword in SQL, 6-15 
orderlst.r RPT script, 9-27 
Orders record type 
adding, 4-8 
explained, viii 
or keyword in SQL, 6-7 
Outer query in SQL, 6-20 
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( 


Output 
characters in SQL, 10-14 
options in SQL, 10-14 
ordering in SQL, 6-15 
printing in SQL, 10·1 


p 


Page length in RPl', 7-5 
PAINT 
editing commands, 5-6 
editing session, 10-9 
help, 5-11 
modes, 5·11 
operation modes, 5-3 
screen form components, 5-4 
Paint Screen Forms (paint), 5-3 
Parameters in SQL, 10-1 
Password 
individual, 13-3 
super user, 13-4 
Pointer, menu, 1·4 
Positioning the cursor on the screen form, 3-2 
Precautions when creating a data base, 2-22 
Primary and secondary record types guidelines, 5-19 
Primary key 
access, 9·4 
explained, 2·2 
value in ENTER, 3-2 
Primary record type, 3-2 
Print 
command in RPl', 7·9 
formats in RPl', 7-1 
Print Data Base Design? option, 2·21 
Print Data Base Design (schIst) option, 4·15 
Print Screens (sfrep), 5·20 
Printer output in ENTER, 9-34, 10-17 
Privileges, access, 13·1 
Program level of security, 13-1 
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Prompt 
development, 2-21 
edit commands in PAINT, 5-8 
menu, 1-5 
operation, 3-2 
paging, 2-5 
screen, 5-4 
search, 5-23 
selection, 1·5 
shell, 8-3 
SQL,6·3 
Prototype application, 2·1 
Purchase Acquisitions Report, 8-1 
purchase.r RPT script, 7·3 
purchase.s SQL script, 8-1 


Q 


queries, SQL 
join, 6·24 
multiple file, 6-24 
nested, 6-19 
Query language 
. 
DML, 6-2, 6-28, 6-31 
SQL, 6-1 
Question mark 
. 
information key, 1-7 
wild character, 9-6 


R 


ranges, numeric and date, 9-5 
Reconfigure Data Base (scom), 4-19 
Record, description, vi 
Records 
expected number of, 2-2 
grouping in SQL, 6-18 
selecting in SQL, 6-7 


records keyword in SQL, 6-5 
Record type 
defining, 2-3 
description, vi 
entry screen, 2-5 
fields, 4-1 
modifying, 4·3 
Registering executables, 8-1 
Register Screen Form with ENTER (entmnt), 9-18 
Register Screen Form with SQL (ssqlmnt), 10-12 
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Relationships 
explicit, 2-2 
one to many, viii 
many to many, ix 
Repeated characters, 7-9 
Report 
data base design, 4-15 
defining, 10-3 
field types, 7-8 
formatting program, 9-1 
processor (RPT), 7·1 
script diagram, 7-2 
script file, 7-1 
Report Menu (rptmenu), 12-1 
Report Option Screen, 9-3 
restart keyword in SQL, 6·9 
RETURN key, 1-2 
RPT 
diagram, 7-2 
files used, 7-1 
keywords, 7-19 
report structure, 7-2 
running from the shell, 7-16 
script, 7-7 
use with other UNIFY tools, 7-21 
s 


Screen field editing commands in PAINT, 5-8 
Screen form 
building with SQL, 10-9 
creating data entry, 2-22 
modifying with PAINT, 5-1 
report, printing, 5-20 
Screen RegiStration 


for ENTER, 9-17 
for SQL, 10-11 
Scripts 
acqlist.r, 10-4 
acqlist.s, 10·4 
purchase.r, 7-3 
purchase.s, 8-1 
RPT,7-7 
Secondary 
keys, 2-2 
record type, 3·2 
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Security 
assigning data base, 13-1 
setting individual user privileges, 13-12 
setting system param~ters, 13-2 
setting user group privileges, 13-5 
Security Maintenance (security) menu, 13-3 
select keyword in SQL, 6-4 
Selecting menu options, 1-8 
Selection 
number, 1-4 
prompt, 1-5 
set keyword in SQL, 6-31 
sh command in RPT, 7-16 
Shell 
script, 8-1 
syntax in RPT, 7-17 
Single 
quotes in RPT, 7-9 
sort in SQL, 6-15 
Size parameters of the data base, 2-21 
skip command in RPT, 7-8 
sort command in RPT, 7-14 
SQL 
by forms, 10-1 
clauses, 6-1 
editing scripts, 6-8 
grouping records with, 6-18 
help features, 6-3 
keywords, 6-1 
ordering output, 6-15 
prompt, 6-3 
query language, 6-1 
registering screens with, 10-11 
Report Options Screen, 10-20 
screen driver, 10-1 
screens, 10-1 
scripts, 10-1 
selecting records with, 6-7 


String 
character, 7-8 
fields,9-6 
parameters, 10-3 
Structured Query Language (SQL), 6-1 
Structure of directory, I-I 
Substitute values, 10-1 
sum keyword in SQL, 6-16 
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Super user 
entry point, 13-4 
rD, 13-4 
password, 13-4 
System Administration (sysadmin) menu, 8-4 
System Startup (login), 13-19 


T 


Text editor, 6-8, 8-2, 10-5, 11-3 
Total aggregate function, 7-10 
u 


unicap file, 1-6 
UNIFY environment vatiable, 1-2 
UNIFY Main Menu (entmenu), 1-4 
unique keyword in SQL, 6-11 
update keyword in SQL, 6-31 
User group, setting privileges, 13-5 
User, setting individual privileges, 13-12 
using keyword in RPl', 7-11 
v 


vi text editor, 6-8, 8-2, 11-3 
w 


where keyword in SQL, 6-7, 6-19, 6-22, 6-24 
width keyword in RPl', 7-15 
Wild 
character, 9-6 
string, 9-6 
Write Data Base Backup (budb), 4-17 
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Software 
Problem Report 


Name 
Street 
_ 


City 
State 
Zip 


Phone 
Date------- 


Instructions 


Use this form to report software bugs or suggested enhancements. Mail 
the form to Unify Corp., 4000 Kruse Place Way, Building Two, Suite 
255, Lake Oswego, OR 97034. 


Category 


Software Problem 


Software Enhancement 


Other 


Software Description 


_____ Supplier 
_ 


Unify Product: Data Base Management System 


Serial If 
~----------------- 


(From the label on your media) 


Operating System 


Rev. 


Hardware Description 


KB 


Sides: 
Single 
_ 


Double 
_ 


9 Track 
_ 


Manufacturer 
CPU 
Memory 
_ 


Disk size 
" Density: 


Single 
_ 


Double 
_ 


Cartridge 
_ 
Tape: 
Peripherals 
_ 
l 


Problem Description 


Describe the problem. (Also describe how to reproduce it, and your 
diagnosis and suggested correction.) Attach a listing if available. 


Unify Use Only 


Tech Support 


Routing Code 


Report Number 


Action Taken: 


Date Received 


Date Resolved 
J 


TUTORIAL MANUAL 
READER'S COMMENT FORM 


Your comments and suggestions are appreciated and will help us to provide the best 
documentation for your use. 


I. 
How would you rate this document for COMPLETENESS? (Please Circle) 


Excellent 
Adequate 
Poor 
4········"············3 ··········_·············2·························1 ··..·....·.········.....0 


2. 
Identify any information that you feel should be included or removed. 


3. 
How would you rate this document for ACCURACY of infonnation? (Please Circle) 


Excellent 
Adequate 
Poor 
4·-··_·_·....·..··3 ·························2······•··············..··1 ························0 


4. 
Specify page and nature of any error(s) found in this document. 


( 


( 


s. 


6. 


How would you rate this document for ORGANIZATION of information? 
(Please Circle) 


Excellent 
Adequate 
Poor 
4·-·················3·..··"··········-·····..2·························1 ·········..·············0 


Describe any fonnat or packaging problems you have experienced with this document. 


TUTORIAL MANUAL 
READER'S COMMENT FORM 


7. 
Do you have any general comments or suggestions regarding this document? 


8. 
We would like to know a little about yoor background as a llSer of this document: 


A. 
Yoor job function 
_ 


B. 
Number of years experience with compllter hardware: operation 
_ 


maintenance 
_ 


C. 
Number of years experience with computer software: IlSCr 
_ 


programmer __..,-_ 


Do yOll want a reply? 0 Yes 0 No. If yOll do, please give IlS YOllr name and address: 


Name 
_ 


Company 
_ 


Add~ 
_ 


City 
State 
Zip Code 
_ 


Thank yOll for your cooperation. 


Unify Corporation 
4000 Kruse Way Place 
Building 2, Suite 2SS 
Lake Oswego, Oregon 97034 


